Skip to content

Commit efa189c

Browse files
author
booster-pack.dev
committed
chore: entropy sweep 2026-04-24 [skip ci]
All 5 domains now grade C/B β€” staleness thresholds crossed for all code dirs.
1 parent bc02964 commit efa189c

1 file changed

Lines changed: 44 additions & 35 deletions

File tree

β€ŽQUALITY_SCORE.mdβ€Ž

Lines changed: 44 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -13,86 +13,86 @@ Domain quality grades based on documentation freshness, test coverage, and code
1313
## Domains
1414

1515
### CLI Core
16-
- **Grade**: B
17-
- **Last Updated**: 2026-02-12 (67 days ago)
16+
- **Grade**: C
17+
- **Last Updated**: 2026-02-12 (71 days ago)
1818
- **Signals**:
19-
- S1 (Code Structure Docs): ⚠️ Yellow - mentioned in docs but not in dedicated code-structure.md
19+
- S1 (Code Structure Docs): ⚠️ Yellow - mentioned in AGENTS.md but no dedicated code-structure.md
2020
- 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
21+
- S3 (Staleness): ❌ Fail - 71 days old, crossed 60-day threshold
22+
- S4 (Open Issues): N/A - issues disabled in this repository
23+
- S5 (Test Coverage): ⚠️ Yellow - no CLI unit tests; testing coverage focused on Extensions
2424
- 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.
25+
- **Notes**: Core CLI functionality documented in AGENTS.md and docs/. Code hasn't been updated since Feb 12. 71 days puts S3 firmly in the red zone.
2626

2727
### Extensions System
28-
- **Grade**: B
29-
- **Last Updated**: 2026-02-10 (69 days ago)
28+
- **Grade**: C
29+
- **Last Updated**: 2026-02-10 (73 days ago)
3030
- **Signals**:
3131
- S1 (Code Structure Docs): ⚠️ Yellow - documented in AGENTS.md, not in separate code-structure.md
3232
- 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
33+
- S3 (Staleness): ❌ Fail - 73 days old, crossed 60-day threshold
34+
- S4 (Open Issues): N/A - issues disabled in this repository
3535
- S5 (Test Coverage): βœ… Pass - comprehensive test_extensions.py with 32KB of test code
3636
- 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.
37+
- **Notes**: Well-tested extension system with strong test coverage. Extensions docs (4 guides in extensions/ dir) are thorough. Staleness is the main concern β€” no changes since Feb 10.
3838

3939
### Templates & Commands
40-
- **Grade**: A
41-
- **Last Updated**: 2026-02-17 (62 days ago)
40+
- **Grade**: C
41+
- **Last Updated**: 2026-02-17 (66 days ago)
4242
- **Signals**:
4343
- S1 (Code Structure Docs): βœ… Pass - documented in spec-driven.md and AGENTS.md
4444
- 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
45+
- S3 (Staleness): ❌ Fail - 66 days old, crossed 60-day threshold
46+
- S4 (Open Issues): N/A - issues disabled in this repository
4747
- S5 (Test Coverage): ⚠️ Yellow - templates tested via integration, not unit tests
4848
- 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.
49+
- **Notes**: 9 command files in templates/commands/ covering specify, plan, tasks, implement, analyze, checklist, clarify, constitution, and taskstoissues workflows. Documentation is solid. Staleness now exceeds 60-day threshold.
5050

5151
### Documentation
52-
- **Grade**: C
53-
- **Last Updated**: 2025-12-04 (137 days ago)
52+
- **Grade**: B
53+
- **Last Updated**: 2025-12-04 (141 days ago)
5454
- **Signals**:
5555
- S1 (Code Structure Docs): βœ… Pass - docs/index.md and installation.md exist
5656
- 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
57+
- S3 (Staleness): ❌ Fail - 141 days old, severely stale
58+
- S4 (Open Issues): N/A - issues disabled in this repository
5959
- S5 (Test Coverage): N/A - documentation doesn't require unit tests
6060
- 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.
61+
- **Notes**: User-facing docs in docs/ (8 markdown files) haven't been updated since Dec 2025. S1 passes (docs exist), S5 N/A, only S3 fails β€” scores a B. Needs refresh to reflect CLI changes from Feb 2026.
6262

63-
### Tests & Quality Assurance
64-
- **Grade**: B
65-
- **Last Updated**: 2026-02-10 (69 days ago)
63+
### Tests & QA
64+
- **Grade**: C
65+
- **Last Updated**: 2026-02-10 (73 days ago)
6666
- **Signals**:
6767
- S1 (Code Structure Docs): ⚠️ Yellow - test structure not explicitly documented
6868
- S2 (FlowChad): N/A - not a frontend repo
69-
- S3 (Staleness): ⚠️ Yellow - 69 days old
70-
- S4 (Open Issues): βœ… Pass - no open issues
69+
- S3 (Staleness): ❌ Fail - 73 days old, crossed 60-day threshold
70+
- S4 (Open Issues): N/A - issues disabled in this repository
7171
- S5 (Test Coverage): ⚠️ Yellow - only test_extensions.py (32KB), no CLI unit tests
7272
- 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.
73+
- **Notes**: Extension tests are comprehensive (pytest configured in pyproject.toml with coverage tracking). Core CLI lacks unit test coverage. Both S1 and S5 are yellow, S3 is red.
7474

7575
## Signal Applicability
7676

7777
| Signal | Applicable | Reason |
7878
|--------|-----------|--------|
7979
| S1 | Yes | Repo has code structure documented in AGENTS.md, spec-driven.md, and docs/ |
8080
| 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) |
81+
| S3 | Yes | Git history available, can measure staleness vs current date (2026-04-24) |
8282
| S4 | No | GitHub issues are disabled in this repository |
8383
| S5 | Yes | Test suite exists (tests/test_extensions.py), pytest configured |
8484
| 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/ |
8685

8786
## Summary
8887

89-
**Overall Quality Grade**: B+
88+
**Overall Quality Grade**: C
9089

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:
90+
All code domains have crossed the 60-day staleness threshold since the 2026-04-21 sweep, triggering S3 failures across the board. Documentation holds at B (only S3 fails, S5 is N/A). Extensions remains the strongest domain due to comprehensive test coverage.
9291

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
92+
Top concerns:
93+
1. **Pervasive Staleness**: All 5 domains exceed 60 days since last code change β€” src (71d), extensions (73d), templates (66d), docs (141d), tests (73d)
94+
2. **CLI Test Coverage**: Core CLI (src/specify_cli/) still has no unit tests
95+
3. **Code Structure Doc Gap**: No dedicated code-structure.md; domains rely on AGENTS.md and spec-driven.md
9696

9797
## History
9898

@@ -104,3 +104,12 @@ The Spec Kit repository demonstrates good documentation and code organization. T
104104
- Templates: A (62-day staleness, comprehensive commands)
105105
- Documentation: C (137-day staleness, needs update)
106106
- Tests: B (69-day staleness, extension-focused)
107+
108+
### 2026-04-24 Daily Sweep
109+
- All code domains crossed 60-day staleness threshold (S3 now ❌ Fail for all)
110+
- CLI Core: C (was B) β€” S3 regression: 67d β†’ 71d, crossed threshold
111+
- Extensions System: C (was B) β€” S3 regression: 69d β†’ 73d, crossed threshold
112+
- Templates & Commands: C (was A) β€” S3 regression: 62d β†’ 66d, crossed threshold
113+
- Documentation: B (was C) β€” S3 still failing (141d), but S5 N/A reduces penalty
114+
- Tests & QA: C (was B) β€” S3 regression: 69d β†’ 73d, crossed threshold
115+
- CLAUDE.md added 2026-04-23: fork context and drift policy documented

0 commit comments

Comments
Β (0)