spec-kitty / spec-kitty/spec-kitty

Doctrine validation skips bundled terminology guard because Toolguide schema rejects references

Open
#2,701 2 comments 0 reactions 0 assignees View on GitHub
catfooding doctrine priority:P1 reliability
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.