init geek calc
Some checks failed
Deploy to GitHub Pages / build-and-deploy (push) Has been cancelled

This commit is contained in:
2025-10-04 10:53:41 +08:00
commit 54f427ea21
45 changed files with 4878 additions and 0 deletions

View File

@@ -0,0 +1,51 @@
<!--
SYNC IMPACT REPORT
Version change: 1.0.0 → 2.0.0
List of modified principles:
- "Correctness First" → "Maintainability"
- "Specification-Driven Development" → "Zero Dependencies"
- "Test-First Implementation" → "Performance"
- "User-Centric Design" → "Testable Design"
- "Performance and Reliability" → "Offline Capability"
- Added "Keyboard Accessibility" as new principle
Added sections: "Keyboard Accessibility" principle, updated "Technical Constraints" and "Review and Quality Process" to reflect new principles
Removed sections: Original five principles (replaced with new ones)
Templates requiring updates:
- .specify/templates/plan-template.md ✅ updated (v1.0.0 → v2.0.0)
- .specify/templates/spec-template.md ⚠ pending (no direct principle references to update)
- .specify/templates/tasks-template.md ⚠ pending (no direct principle references to update)
Follow-up TODOs: None
-->
# Geek Calculator Constitution
## Core Principles
### Maintainability
All code MUST be maintainable with clear, readable structure; Code MUST include documentation for complex algorithms; Refactoring MUST be performed when code complexity exceeds team standards.
### Zero Dependencies
Application MUST be built with native HTML/CSS/JavaScript only; No external libraries or frameworks permitted; All functionality MUST be implemented with vanilla web technologies.
### Performance
Total application resources MUST be under 50KB; All operations MUST complete within 100ms; Application MUST load and respond immediately without lag.
### Testable Design
All functionality MUST be covered by automated tests; Tests MUST be written before implementation (TDD approach); All code paths MUST be verifiable through automated test suites.
### Offline Capability
Application MUST function completely offline using service workers; All core calculator operations MUST be available without network connection; Data and state MUST persist across offline sessions.
### Keyboard Accessibility
Full functionality MUST be accessible through keyboard controls only; All interactive elements MUST follow standard keyboard navigation patterns; Application MUST comply with WCAG accessibility standards.
## Technical Constraints
Must use HTML5, CSS3, and ECMAScript 6+ standards; Must work in all modern browsers; Must be responsive across device sizes; Total bundle size MUST remain under 50KB; No external APIs or services allowed.
## Review and Quality Process
Code reviews require verification of bundle size <50KB; All functionality must work offline during review; Accessibility must be verified with keyboard-only navigation; All new features require test coverage before merging.
## Governance
All development MUST comply with constitutional principles; Changes to principles require new constitution version; Code reviews MUST verify constitutional compliance; All team members are responsible for upholding these principles.
**Version**: 2.0.0 | **Ratified**: 2025-01-01 | **Last Amended**: 2025-10-03