spec-kitty / spec-kitty/spec-kitty
Doctrine validation skips bundled terminology guard because Toolguide schema rejects references
- Dominant language
- Python
- Stars
- 1.6k
- Forks
- 165
- Avg merge
- 14h 52m
- Merged PRs (30d)
- 303
Description
Observed while running implement/review for #2658 (TF-034).
## Reproduction
1. Run `spec-kitty agent action implement WP01 --agent --mission `.
2. Run the corresponding review action.
3. Capture doctrine validation warnings.
4. Observe `terminology-guard.toolguide.yaml` skipped because its `references` field is rejected as an extra input by the installed Toolguide model.
## Expected
Packaged governance assets and runtime schemas must be version-compatible. A bundled toolguide should validate and load, or installation/upgrade should fail with an actionable compatibility repair rather than silently dropping it.
Contributor guide
Research direction
Reproduce the issue with `spec-kitty agent action implement WP01 --agent --mission ` and the corresponding review action, then inspect how `terminology-guard.toolguide.yaml` is validated against the installed Toolguide model. Done means the bundled toolguide validates and loads, or installation/upgrade reports an actionable compatibility repair instead of silently skipping it.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100