mcpField
W
w-architecture

w-architecture

github.com/blockmatic-iceboxDevelopment1647 installsUpdated 4w ago
Repository

About w-architecture

w-architecture is an agent skill for planning implementation structure within a repository’s existing architecture. It directs durable decisions to established ADRs and documentation, and returns plans in chat unless a save path is provided.

Key features

  1. 01Review architecture docs and ADRs
  2. 02Keep plans within existing architecture
  3. 03Separate goals from nice-to-haves
  4. 04List constraints, trade-offs, and alternatives
  5. 05State assumptions and flag high-risk items
  6. 06Use Mermaid when structure needs clarification

Use cases

  1. 01Plan implementation for a repository change
  2. 02Assess trade-offs before coding
  3. 03Document durable architecture boundaries in existing records

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/blockmatic-icebox/basilic-skills --skill w-architecture

After installing, type/w-architecturein Claude Code to confirm it loaded.

Details

From the project README

Produce an implementation-structure plan for the user's question. Durable system decomposition belongs in existing ADRs and architecture MDX. Do not mint a second ADR tree. Do not create a branch.

  1. If this turn has no reconciled exploration for the area, follow council steps 1–3, then continue.
  2. Read the matching architecture MDX and ADRs. If the change is a durable boundary, stop and document it in the existing ADR/docs system.
  3. State implementation goals vs nice-to-haves. Stay inside the existing architecture unless the user already authorized a durable architecture decision.
  4. List constraints, trade-offs, and alternatives that affect this change. Flag high-risk items for a human. State 3–5 assumptions.
  5. Add Mermaid only when structure or flow is otherwise unclear.
  6. Save only if the user gave a path; otherwise return in chat. Include Assumptions and References (plain paths). Commands and generated-source owners come from inspected docs.

Comments

Markdown supported