plan-architecture

SkillDev tools

Plan an implementation structure; hand durable architecture decisions to FIRST. Use when the user types /plan-architecture.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the plan-architecture skill

What this skill tells your AI

The instructions your AI receives, as published by blockmatic/basilic in .agents/skills/workflow/plan-architecture/SKILL.md and read by ahel’s review.

Purpose and inputs

Produce an implementation-structure plan for the user's question. Durable system decomposition and ADRs belong to /f-architecture and ARCHITECTURE.md. Do not mint a second ADR tree.

Steps

  1. Load FIRST and read the architecture overlay plus matching technical MDX. If the change is a durable boundary, stop and use /f-architecture.
  2. State implementation goals vs nice-to-haves. Stay inside the existing architecture unless the user already authorized a station decision.
  3. List constraints, trade-offs, and alternatives that affect this change. Flag high-risk items for a human.
  4. Add Mermaid only when structure or flow is otherwise unclear.
  5. Save only if the user gave a path; otherwise return in chat. Include assumptions and References. Do not create a branch.

Verification

  • The plan does not replace ARCHITECTURE.md or invent an ADR location.
  • Assumptions and deferrals are explicit.
  • Commands and generated-source owners come from inspected docs.

Handoff

Return the plan location or chat body and whether /f-architecture is still required.

Signals

GitHub stars
89
Forks
11
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
plan-architecture
Source
github.com/blockmatic/basilic