architect
Decide what the system should become before /spec commits an implementation plan. Runs inline in the active coding-agent session, grounds every claim in current repository sources, and returns one Architecture Brief. TRIGGER when: a change alters module/system boundaries, the execution or ownership model, persistent state, a security or isolation boundary, a public API or compatibility contract, a lifecycle/state machine, provider portability, shared vocabulary, cross-skill control-plane behavior, a new reusable abstraction, the retirement of an existing one, or any structural decision that is expensive to reverse; asked to "design this", "what should the architecture be", "is this architecturally significant", "ADR for X", before /spec plan on a structural change. Do NOT trigger for ordinary local changes — a bug fix, a copy edit, a new test, a contained refactor inside one module.
mifunedev · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add mifunedev/agro --skill architect技能说明
name: architect description: | Decide what the system should become before /spec commits an implementation plan. Runs inline in the active coding-agent session, grounds every claim in current repository sources, and returns one Architecture Brief. TRIGGER when: a change alters module/system boundaries, the execution or ownership model, persistent state, a security or isolation boundary, a public API or compatibility contract, a lifecycle/state machine, provider portability, shared vocabulary, cross-skill control-plane behavior, a new reusable abstraction, the retirement of an existing one, or any structural decision that is expensive to reverse; asked to "design this", "what should the architecture be", "is this architecturally significant", "ADR for X", before /spec plan on a structural change. Do NOT trigger for ordinary local changes — a bug fix, a copy edit, a new test, a contained refactor inside one module. argument-hint: "<problem | issue number | plan path>" allowed-tools: Read, Glob, Grep, Bash
Architect
Determine what the system should become before /spec commits the
implementation plan. This skill decides architecture; it does not implement.
Arguments received: $ARGUMENTS
Execution model
Run inline in the active coding-agent session. The session that invoked
/architect keeps ownership of the work and of everything that follows it.
- Do not fork the context, launch another coding-agent process, open a tmux or Herdr session, or hand the decision to a separate persistent identity.
- Do not create an
architectagent definition. The role is this skill; the runtime is the session already reading it. - Use
/delegateonly for bounded, self-contained fan-out — parallel independent source reads whose verbose output should stay out of this context. Reconcile every delegated result here; the brief is written by this session.
Roles are behavior, skills encode behavior, and agents execute behavior. A second agent context is justified only when isolation or parallelism is itself the thing being bought.
1. Classify
Architecture review is selective, not ceremony. Treat the change as ARCHITECTURAL when it materially affects one or more of:
- system or module boundaries;
- the execution or ownership model;
- persistent state or the data model;
- a security or isolation boundary;
- a public API or compatibility contract;
- a lifecycle or state machine;
- provider portability;
- shared conceptual vocabulary;
- cross-skill or control-plane behavior;
- a new reusable abstraction;
- the replacement or retirement of an existing abstraction;
- a structural decision that is difficult or expensive to reverse.
Otherwise the change is NOT-ARCHITECTURAL. Say so in two or three
sentences, name the reason, route the work straight to /spec plan, and stop.
Do not produce the full brief for a small local change.
2. Ground the decision
Before reasoning, read real sources. Synthesized recall is advisory; current source and accepted decision records are authority.
- Read every applicable
AGENTS.mdfrom the repository root down to the directories the change touches. Local instructions win; in one directoryAGENTS.mdis canonical. - Read the RFC/ADR index at
docs/rfcs/README.mdand any listed proposal that already constrains this decision. An accepted decision is a constraint until a new proposal supersedes it. - Query tracked repository knowledge when it is available:
/wiki query <subsystem> --patternsreturns failure modes this harness has already paid for. Cite the[[pattern-...]]slugs that changed the recommendation. - Inspect the authoritative code, tests, probes, and docs for the surfaces in scope. Read them; do not infer their shape.
- Name the actual decision or decisions. A feature request restated is not a decision.
- Label every claim as fact, constraint, assumption, or judgment. An unverified assumption must say so.
3. Decide
For each material decision, work through:
- Current state — what exists now, cited by path.
- Drivers — the outcome wanted and why now.
- Invariants — what must survive the change untouched.
- Options — including reuse, extend, retire, and do-nothing where those are live. A single-option brief is not an analysis.
- Tradeoffs — complexity, reversibility, portability, security, operability, context cost, migration risk.
- Interaction — how the option meets existing accepted decisions.
- Failure modes — how it breaks, and how it rolls back.
- Retirement — what this consolidates or deletes rather than adds beside.
- Falsification — the evidence that would show the recommendation wrong.
Favor the smallest architecture that satisfies the actual requirement. Do not add an orchestration or process layer without evidence it improves outcomes. Prefer deleting an abstraction to growing a second one next to it.
4. Record durable decisions
Durable architecture decisions reuse the existing convention in
docs/rfcs/README.md: a GitHub issue titled
ADR: <title> (or RFC: <title>), moving through Draft → Accepted →
Superseded, indexed on that page.
Do not invent an architecture database, service, document taxonomy, decision directory, or per-skill decision store. Do not require a record for every change — most decisions are captured well enough by the code and its probes. Propose a record only when the decision is architecturally significant and expensive to rediscover.
5. Output
Return exactly one compact brief. When the classification is
NOT-ARCHITECTURAL, return only the classification, the reason, and the
routing sentence.
## Architecture Brief
### Classification
ARCHITECTURAL | NOT-ARCHITECTURAL
### Current State
...
### Decision Drivers
- ...
### Invariants
- ...
### Options Considered
1. ...
2. ...
3. ...
### Recommendation
...
### Trad
阅读完整来源 ↗