The Skill can directly rewrite approved product and technical specifications during implementation
Source references: 4The Skill tells the agent to update checked-in PRODUCT.md or TECH.md when it concludes that intended behavior or design “should change,” without requiring renewed approval from the user or original approver for material changes. Keeping specifications and code in one PR aids review, but does not ensure reviewers recognize a specification edit as a new product decision.
Implementation difficulty or agent judgment could become a new requirement, user experience, architecture, or success criterion. The code would then be validated against the rewritten specification rather than the scope the user originally approved.
The Skill requires approval only before implementation starts. If behavior or design later “should change,” it directs the agent to update checked-in PRODUCT.md/TECH.md and include those changes with the code in one PR. A PR enables review, but the text does not require pausing for renewed authorization after material product, UX, architecture, or validation changes. An implementation judgment could therefore become a specification decision affecting user expectations and later approvals. Users can ask the author to add an explicit re-approval gate and restrict the agent to proposing such changes until approval is given.
### 4. Update specs as the implementation evolvesIf implementation reveals that the intended behavior or design should change, update the checked-in specs rather than letting them go stale.In particular:- update `PRODUCT.md` when user-facing behavior, UX, edge cases, or success criteria change- update `TECH.md` when architecture, sequencing, module boundaries, or validation strategy change- keep those updates in the same PR as the corresponding code changesThe PR should describe the feature that actually ships, not just the initial draft of the specs.Show 3 other places
Before considering the work complete, verify that the code matches the current specs.- confirm that `PRODUCT.md` exists- confirm that `TECH.md` exists when the feature warranted one- confirm that the relevant specs have been reviewed and approved enough to start implementation- update `PRODUCT.md` when user-facing behavior, UX, edge cases, or success criteria change- update `TECH.md` when architecture, sequencing, module boundaries, or validation strategy change- keep those updates in the same PR as the corresponding code changes