Skill Detail
review_specs
review_specs defines the repository workflow for auditing affected DS files against new context, explicit instructions, and current implementation details. It is the skill to use when the specification set needs disciplined review rather than piecemeal copy edits.
| Depends on | gamp_specs |
|---|---|
| Primary artifacts | SKILL.md, DS.md |
| Primary spec | DS010-review-specs.md |
Review Method
The skill requires an explicit task set, step-by-step inspection of each affected DS, and synchronization of every companion artifact that shares the contract surface. It treats implementation, user instructions, and existing repository guidance as equally important sources that must be reconciled rather than paraphrased independently.
Core Content vs. Decisions
The central distinction is that Core Content carries the contract backbone: general approach, limits, special cases, and invariants. Decisions & Questions carries the detailed rationale and any unresolved alternatives through numbered subchapters such as ### Question #1: .... That section may grow as large as needed, while the contract backbone should stay concise and stable.
Downstream Documentation Boundary
The skill also reinforces the repository-wide rule that downstream consumer projects should not mirror imported-skill DS files or skill pages under the host project's docs/ tree. Review work must preserve that boundary when specifications are revised.