NoizuPromptLingo: Command for Claude Code

Update Architecture Documentation

Refresh and expand architecture documentation, updating stale content and expanding stub files with detailed analysis.

Inputs: Existing docs/PROJECT-ARCH.md and stub files Outputs: Updated docs/PROJECT-ARCH.md and expanded docs/PROJECT-ARCH/*.md sub-files

NPL Dependencies

Load NPL definitions before proceeding using the NPLLoad MCP tool:

NPLLoad(expression="syntax fences directives pumps")

See Also

• Fence type reference (diagram, example, format)
• Directive patterns (📐, 🗺️, 🔧, 📂)
• Reasoning pump documentation
• Agent declaration syntax

---

Design Philosophy

incremental : Only regenerate sections that are stale or incomplete — preserve manual edits

expand-stubs : Transform stub files from /init-project-fast into full detailed documentation

drift-detection : Identify discrepancies between documentation and current codebase

preserve-intent : Maintain architectural decisions and rationale added by humans

---

Phase 1: Analyze Current State

1.1 Inventory Existing Documentation

Check current documentation state:

inventory = {
    main_file: check_exists("docs/PROJECT-ARCH.md"),
    sub_files: glob("docs/PROJECT-ARCH/*.md"),
    stubs: [],
    detailed: [],
    missing: []
}

for file in inventory.sub_files:
    if contains(file, "Stub generated by init-project"):
        inventory.stubs.append(file)
    else:
        inventory.detailed.append(file)

# Expected sub-files per spec
expected = ["layers.md", "domain.md", "patterns.md", "infrastructure.md"]
for expected_file in expected:
    if expected_file not in inventory.sub_files:
        inventory.missing.append(expected_file)

1.2 Determine Update Mode

Condition	Mode	Action
No PROJECT-ARCH.md exists	full-init	Run /init-project instead
Stubs exist	expand	Expand stubs to detailed files
All detailed, possible drift	refresh	Validate and update stale sections
User requests specific section	targeted	Update only requested sections