Synchronize ARCHITECTURE.md with changes made during execplan implementation.
Workflow
Read the completed execplan .agent/execplan-pending.md
Locate ARCHITECTURE.md at the repo root
Analyze what was implemented in the execplan and identify architectural impacts:
New modules or bounded contexts
Changed data flows or boundaries
New integrations or dependencies
Updated directory structure
New cross-cutting concerns
Update only the affected sections of ARCHITECTURE.md
If diagrams exist, update Mermaid diagrams to reflect new components/flows
After all of your updates, stage any unstaged changes, then commit.
Update Principles
Preserve existing structure and formatting
Add to existing sections rather than rewriting
Update Key Design Decisions with new decisions made during implementation
Move resolved items from Open Questions to appropriate sections
Keep the same level of detail as the existing doc
If No ARCHITECTURE.md Exists
Create one using the architecture-docs-creator skill template, populated with the current state post-implementation.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: grp06-useful-codex-skills-update-architecture-docs3description: Update Architecture Docs4---56# Update Architecture Docs78Synchronize ARCHITECTURE.md with changes made during execplan implementation.910## Workflow11121. Read the completed execplan `.agent/execplan-pending.md`132. Locate ARCHITECTURE.md at the repo root143. Analyze what was implemented in the execplan and identify architectural impacts:15 - New modules or bounded contexts16 - Changed data flows or boundaries17 - New integrations or dependencies18 - Updated directory structure19 - New cross-cutting concerns204. Update only the affected sections of ARCHITECTURE.md215. If diagrams exist, update Mermaid diagrams to reflect new components/flows226. After all of your updates, stage any unstaged changes, then commit. 2324## Update Principles2526- Preserve existing structure and formatting27- Add to existing sections rather than rewriting28- Update Key Design Decisions with new decisions made during implementation29- Move resolved items from Open Questions to appropriate sections30- Keep the same level of detail as the existing doc3132## If No ARCHITECTURE.md Exists3334Create one using the architecture-docs-creator skill template, populated with the current state post-implementation.3536---37> Converted and distributed by [TomeVault](https://tomevault.io/claim/grp06) — claim your Tome and manage your conversions.38<!-- tomevault:4.0:skill_md:2026-04-11 -->
Run npx skillmds@latest add tomevault-io/grp06-useful-codex-skills-update-architecture-docs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Update Architecture Docs It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.