2.2 KiB
2.2 KiB
allowed-tools, description, model
| allowed-tools | description | model |
|---|---|---|
| Read, Bash(reqvire:*) | Lint and clean up the Reqvire model by fixing issues and identifying items needing review | claude-sonnet-4-5-20250929 |
Lint Model
Lint the Reqvire model to fix quality issues and identify items needing manual review.
Current Lint Status
- Auto-fixable: !
reqvire lint --json 2>&1 | jq -r '"\(if .auto_fixable then (.auto_fixable | length) else 0 end) issues"' - Manual review: !
reqvire lint --json 2>&1 | jq -r '"\(if .needs_manual_review then (.needs_manual_review | length) else 0 end) items"'
Steps
-
Apply auto-fixes immediately:
reqvire lint --fixThis automatically fixes:
- Syntax and formatting issues
- Redundant verify relations (verification verifying both leaf and parent)
- Safe redundant hierarchical relations (single-chain derivedFrom paths)
-
Check for manual review items:
reqvire lint --json > /tmp/lint.json jq '.needs_manual_review' /tmp/lint.json -
For manual review items:
Read affected specifications:
reqvire search --filter-id="<element-id>"Provide recommendations:
- Show the potentially redundant relation
- Explain why it may be redundant
- Ask user if they want to remove it
-
Validate after changes:
reqvire validate
Lint Categories
Auto-Fixable (always safe to apply)
- Redundant verify relations: Verification verifies both leaf and parent requirement
- Safe redundant hierarchical relations: Single-chain derivedFrom paths that can be safely removed
Needs Review (requires judgment)
- Multi-branch convergence: Element reaches ancestor through multiple distinct paths
- Complex hierarchical relations: Multi-path derivedFrom relations requiring human judgment
Best Practices
- Run
reqvire lint --fixafter adding features - Review manual items carefully before removing
- Validate model after manual changes
- Use after
/add-featureor/add-verificationto clean up
Notes
- Auto-fixes are always safe - just apply them
- Manual review items need human judgment and context
- Run lint regularly to maintain model quality