w-architecture
Plan an implementation structure; durable decisions belong in ADRs and architecture docs.
- Installs
- 647
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/blockmatic/basilic-skills --skill w-architecture- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads w-architecture automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
- If this turn has no reconciled exploration for the area, follow council steps 1–3, then continue.
- Read the matching architecture MDX and ADRs. If the change is a durable boundary, stop and document it in the existing ADR/docs system.
- State implementation goals vs nice-to-haves. Stay inside the existing architecture unless the user already authorized a durable architecture decision.
- List constraints, trade-offs, and alternatives that affect this change. Flag high-risk items for a human. State 3–5 assumptions.
- Add Mermaid only when structure or flow is otherwise unclear.
- 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.
FAQ
What does the w-architecture skill do?
Plan an implementation structure; durable decisions belong in ADRs and architecture docs.
How do I install w-architecture?
Run npx skills add https://github.com/blockmatic/basilic-skills --skill w-architecture in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/w-architecture/ (personal) or .claude/skills/w-architecture/ (project).
Which AI agents can use w-architecture?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is w-architecture safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains w-architecture?
It is published by blockmatic in blockmatic/basilic-skills. It has 647 recorded installs.
More from blockmatic/basilic-skills
workflow
blockmatic/basilic-skills
Basilic /w- playbooks packed so install lands at .agents/skills/workflow/w-plan and the rest.
w-review-plan
blockmatic/basilic-skills
Review a plan's Goals, Assumptions, Tasks, Risks, and References.
w-api-test
blockmatic/basilic-skills
Add API tests that exercise public HTTP behavior against existing harnesses.
w-git-repair
blockmatic/basilic-skills
Resolve common Git problems and conflicts with inspected commands.
w-perf
blockmatic/basilic-skills
Measure bottlenecks with repository tools, then recommend or apply evidenced optimizations.
w-clarify
blockmatic/basilic-skills
Resolve consequential missing requirements from inspected context.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.