59 lines
1.5 KiB
Plaintext
59 lines
1.5 KiB
Plaintext
# webref Development Guidelines
|
|
|
|
Auto-generated from all feature plans. Last updated: 2025-11-01
|
|
|
|
## Constitutional Principles
|
|
|
|
This project follows a formal constitution (`.specify/memory/constitution.md`). All development work MUST align with these principles:
|
|
|
|
1. **Code Quality & Maintainability** - Clear, maintainable code with proper typing
|
|
2. **Testing Discipline** - ≥80% coverage, automated testing required
|
|
3. **User Experience Consistency** - Intuitive, accessible interfaces
|
|
4. **Performance & Efficiency** - Performance-first design with bounded resources
|
|
|
|
Reference the full constitution for detailed requirements and enforcement mechanisms.
|
|
|
|
## Active Technologies
|
|
|
|
- (001-reference-board-viewer)
|
|
|
|
## Project Structure
|
|
|
|
```text
|
|
src/
|
|
tests/
|
|
```
|
|
|
|
## Commands
|
|
|
|
# Add commands for
|
|
|
|
## Code Style
|
|
|
|
: Follow standard conventions
|
|
|
|
### Constitutional Requirements
|
|
|
|
All code MUST meet these standards (per Principle 1):
|
|
- Linter passing (zero errors/warnings)
|
|
- Type hints on all public APIs
|
|
- Clear single responsibilities (SRP)
|
|
- Explicit constants (no magic numbers)
|
|
- Comments explaining "why" not "what"
|
|
|
|
## Testing Standards
|
|
|
|
Per Constitutional Principle 2:
|
|
- Minimum 80% test coverage required
|
|
- Unit tests for all public functions
|
|
- Integration tests for component interactions
|
|
- Edge cases and error paths explicitly tested
|
|
- Tests are deterministic, isolated, and fast (<1s unit, <10s integration)
|
|
|
|
## Recent Changes
|
|
|
|
- 001-reference-board-viewer: Added
|
|
|
|
<!-- MANUAL ADDITIONS START -->
|
|
<!-- MANUAL ADDITIONS END -->
|