skills.rest
aoecosystem
aoecosystemOFFICIAL
Explore all skills by this author →
GitHub

review-architecture

Edit System Architecture HTML sections with versioned audit logging.

Updated Apr 26, 2026
Search Tags:#workflow#architecture#versioning#system-architecture#audit-log#section-editing
One-click install
npx skills add https://github.com/aoecosystem/project-foundations --skill review-architecture-aoecosystem
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-architecture
Source: https://github.com/aoecosystem/project-foundations/tree/main/.cursor/skills/review-architecture
Command: npx skills add https://github.com/aoecosystem/project-foundations --skill review-architecture-aoecosystem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables targeted edits to the System Architecture HTML without regenerating the entire document, preserving structure and reducing churn.

Core Features & Use Cases

  • Guided, section-level edits: choose from Architecture Overview, Service Inventory, Layered Architecture, Data Flow, Module Boundaries & Contracts, Cross-Cutting Concerns, and Architecture — Visual Diagram; updates are staged and versioned with an audit trail.
  • Stage-aware workflow: only operates when Stage is ARCHITECTURE_DRAFT or ARCHITECTURE_APPROVED; reopens ARCHITECTURE_APPROVED back to DRAFT if needed; downstream artifacts remain on disk but should be rebuilt.
  • Audit and versioning: every change bumps the version and appends an audit log, ensuring traceability.

Quick Start

Invoke /review-architecture <section> or say edit architecture to start editing a specific architecture section.

Frequently Asked Questions about review-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I edit specific sections of system architecture HTML without regenerating the whole document?▼

You can perform section-level edits on system architecture HTML to update individual sections like Service Inventory or Data Flow while preserving the overall document structure and avoiding full regeneration churn.

What is the best way to maintain an audit log when modifying architecture documents?▼

Maintaining an audit log during architecture modifications is handled automatically; every section edit appends an audit entry and bumps the version number, ensuring full traceability of all structural changes.

Can I update architecture visual diagrams and module boundaries individually?▼

Yes, you can update architecture visual diagrams and module boundaries individually through targeted section editing, which stages each modification separately to isolate changes to specific architectural components.

When do I need to reopen an approved architecture draft for revisions?▼

Reopening an approved architecture draft is needed when further revisions are required; editing an approved architecture section automatically transitions the stage back to draft to allow modifications.

Are there stage restrictions for modifying system architecture sections?▼

Yes, section modifications are stage-restricted and only operate when the session state is set to ARCHITECTURE_DRAFT or ARCHITECTURE_APPROVED, enforcing pre-flight and stage-gate rules for safe edits.

What happens to downstream artifacts after editing an approved architecture section?▼

Downstream artifacts remain on disk after editing an approved architecture section, but they become stale and should be rebuilt to reflect the latest versioned changes and updated module contracts.

Related Skills

Explore More Software Engineering Skills→
paradox123paradox123

context-bootstrap

Collect repository structure, runnable commands, and architecture anchors at startup.

Community
Intermediate
SourceLinSourceLin
9

architecture-refactor

Coordinate incremental architecture refactoring across platforms with AGENTS.md and rules.

Community
Intermediate
aoecosystemaoecosystem

review-database

Apply stage-gated section edits to the Database Diagram with audit logging.

Official
Advanced
aiyinluyaaiyinluya
2

sn-search-academic

Search academic papers across ArXiv, Semantic Scholar, PubMed, and Wikipedia.

Community
Intermediate