decision-doc-sync
Trigger: architecture change, new convention, UI/UX standard, quality gate change, ADR. Keep existing project docs in sync with structural decisions.
How do I install this agent skill?
npx skills add https://github.com/c3sc0-v4113/scaffold --skill decision-doc-syncIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill manages documentation synchronization by reading project code and updating files like README.md and ADRs. While it performs legitimate documentation tasks, it has an inherent vulnerability surface for indirect prompt injection because it ingests untrusted source code and modifies file content without using explicit boundary markers or sanitization filters to prevent the agent from executing instructions embedded in the code.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Decision Documentation Sync
Activation Contract
Load this skill when a change introduces or changes a structural decision: architecture, UI/UX standards, scripts or quality gates, or a cross-cutting convention.
Hard Rules
- Check which documents exist before editing; update only documents that exist, and create one only when a rule below requires it.
- Keep each fact in one document and link to it from others instead of duplicating it.
- Record the decision itself, not the change history.
- Never leave a document contradicting the code after the change.
Decision Gates
| Change type | Document |
|---|---|
| Architecture, folder structure, scripts | README.md |
| Visual or UX standard, tokens, component usage | DESIGN.md |
| Agent workflow, commands, operational guidance | AGENTS.md |
| Durable decision with alternatives and consequences | new record in docs/adr/ |
Execution Steps
- Check which of
README.md,DESIGN.md,AGENTS.md, anddocs/adr/exist. - Classify the change with the table above; one change may hit several rows.
- Update each affected document that exists.
- For an ADR, follow the existing numbering and format in
docs/adr/; see references/doc-map.md. - Reread the edited sections against the code.
Output Contract
List every document updated, created, or deliberately skipped, with a one-line reason each.
References
- references/doc-map.md — ADR format and edge cases.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/c3sc0-v4113/scaffold/decision-doc-sync">View decision-doc-sync on skillZs</a>