Skip to content

Commit 4217a7b

Browse files
author
booster-pack.dev
committed
entropy: daily sweep [skip ci]
1 parent c5c6d65 commit 4217a7b

1 file changed

Lines changed: 106 additions & 0 deletions

File tree

‎QUALITY_SCORE.md‎

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,106 @@
1+
# Quality Score Report
2+
3+
Domain quality grades based on documentation freshness, test coverage, and code staleness.
4+
5+
## Grading Scale
6+
7+
- **A**: Excellent (0 signals failing)
8+
- **B**: Good (1 signal failing or 2 yellow)
9+
- **C**: Fair (2-3 signals failing)
10+
- **D**: Poor (3+ signals failing)
11+
- **F**: Failing (no documentation)
12+
13+
## Domains
14+
15+
### CLI Core
16+
- **Grade**: B
17+
- **Last Updated**: 2026-02-12 (67 days ago)
18+
- **Signals**:
19+
- S1 (Code Structure Docs): ⚠️ Yellow - mentioned in docs but not in dedicated code-structure.md
20+
- S2 (FlowChad): N/A - not a frontend repo
21+
- S3 (Staleness): ⚠️ Yellow - 67 days old, moderate staleness
22+
- S4 (Open Issues): ✅ Pass - no issues (disabled in repo)
23+
- S5 (Test Coverage): ⚠️ Yellow - limited CLI tests, mainly extensions tested
24+
- S6 (Hookshot): N/A - no .claude/doc-coverage.json
25+
- **Notes**: Core CLI functionality is documented in AGENTS.md and docs/. Recently touched (Feb 12), but docs haven't been updated since Dec 2025.
26+
27+
### Extensions System
28+
- **Grade**: B
29+
- **Last Updated**: 2026-02-10 (69 days ago)
30+
- **Signals**:
31+
- S1 (Code Structure Docs): ⚠️ Yellow - documented in AGENTS.md, not in separate code-structure.md
32+
- S2 (FlowChad): N/A - not a frontend repo
33+
- S3 (Staleness): ⚠️ Yellow - 69 days old, moderate staleness
34+
- S4 (Open Issues): ✅ Pass - no open issues
35+
- S5 (Test Coverage): ✅ Pass - comprehensive test_extensions.py with 32KB of test code
36+
- S6 (Hookshot): N/A - no .claude/doc-coverage.json
37+
- **Notes**: Well-tested extension system with good test coverage (test_extensions.py). AGENTS.md provides excellent documentation on adding agents.
38+
39+
### Templates & Commands
40+
- **Grade**: A
41+
- **Last Updated**: 2026-02-17 (62 days ago)
42+
- **Signals**:
43+
- S1 (Code Structure Docs): ✅ Pass - documented in spec-driven.md and AGENTS.md
44+
- S2 (FlowChad): N/A - not a frontend repo
45+
- S3 (Staleness): ✅ Pass - 62 days old, recent update
46+
- S4 (Open Issues): ✅ Pass - no open issues
47+
- S5 (Test Coverage): ⚠️ Yellow - templates tested via integration, not unit tests
48+
- S6 (Hookshot): N/A - no .claude/doc-coverage.json
49+
- **Notes**: Command templates are well-organized and documented. 9 command files in templates/commands/ covering specify, plan, tasks, implement, analyze, checklist, clarify, constitution, and taskstoissues workflows.
50+
51+
### Documentation
52+
- **Grade**: C
53+
- **Last Updated**: 2025-12-04 (137 days ago)
54+
- **Signals**:
55+
- S1 (Code Structure Docs): ✅ Pass - docs/index.md and installation.md exist
56+
- S2 (FlowChad): N/A - not a frontend repo
57+
- S3 (Staleness): ❌ Fail - 137 days old, significantly stale
58+
- S4 (Open Issues): ✅ Pass - no open issues
59+
- S5 (Test Coverage): N/A - documentation doesn't require unit tests
60+
- S6 (Hookshot): N/A - no .claude/doc-coverage.json
61+
- **Notes**: Documentation is moderately stale. Last update in Dec 2025. docs/ contains 8 markdown files (index, installation, quickstart, upgrade, local-development, README, docfx.json, toc.yml). Needs refresh to reflect recent CLI updates from Feb 2026.
62+
63+
### Tests & Quality Assurance
64+
- **Grade**: B
65+
- **Last Updated**: 2026-02-10 (69 days ago)
66+
- **Signals**:
67+
- S1 (Code Structure Docs): ⚠️ Yellow - test structure not explicitly documented
68+
- S2 (FlowChad): N/A - not a frontend repo
69+
- S3 (Staleness): ⚠️ Yellow - 69 days old
70+
- S4 (Open Issues): ✅ Pass - no open issues
71+
- S5 (Test Coverage): ⚠️ Yellow - only test_extensions.py (32KB), no CLI unit tests
72+
- S6 (Hookshot): N/A - no .claude/doc-coverage.json
73+
- **Notes**: Extension tests are comprehensive, but CLI core lacks unit test coverage. pytest configured in pyproject.toml with coverage tracking enabled.
74+
75+
## Signal Applicability
76+
77+
| Signal | Applicable | Reason |
78+
|--------|-----------|--------|
79+
| S1 | Yes | Repo has code structure documented in AGENTS.md, spec-driven.md, and docs/ |
80+
| S2 | No | Not a frontend repository - no React/Next/Vue, no .flowchad directory |
81+
| S3 | Yes | Git history available, can measure staleness vs current date (2026-04-21) |
82+
| S4 | No | GitHub issues are disabled in this repository |
83+
| S5 | Yes | Test suite exists (tests/test_extensions.py), pytest configured |
84+
| S6 | No | No .claude/doc-coverage.json file exists in repository |
85+
| S7 | Yes | Template commands source of truth: 9 command files in templates/commands/ |
86+
87+
## Summary
88+
89+
**Overall Quality Grade**: B+
90+
91+
The Spec Kit repository demonstrates good documentation and code organization. The Extensions system is well-tested and documented. Templates are recent and comprehensive. Main concerns:
92+
93+
1. **Documentation Staleness**: User-facing docs haven't been updated since Dec 2025 (137 days)
94+
2. **CLI Test Coverage**: Core CLI lacks unit tests; testing coverage focused on Extensions
95+
3. **Code Structure Documentation**: Architecture documented in AGENTS.md and spec-driven.md, but no dedicated code-structure.md file
96+
97+
## History
98+
99+
### 2026-04-21 Daily Sweep
100+
- Analyzed all domains
101+
- Assessed signal applicability for Python/CLI-based repo
102+
- CLI Core: B (67-day staleness, good docs, moderate test coverage)
103+
- Extensions: B (69-day staleness, excellent test coverage)
104+
- Templates: A (62-day staleness, comprehensive commands)
105+
- Documentation: C (137-day staleness, needs update)
106+
- Tests: B (69-day staleness, extension-focused)

0 commit comments

Comments
 (0)