# Architect

> Use when task involve design spec, ADR, one-way-door decision, or evaluate trade-offs between architectural approaches. Invoke before implementation when requirements span subsystems or decision hard reverse. Trigger: /architect.

- **Type:** Skill
- **Install:** `agentstack add skill-grimoire-rs-grimoire-architect`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [grimoire-rs](https://agentstack.voostack.com/s/grimoire-rs)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [grimoire-rs](https://github.com/grimoire-rs)
- **Source:** https://github.com/grimoire-rs/grimoire/tree/main/.claude/skills/architect
- **Website:** https://grimoire.rs

## Install

```sh
agentstack add skill-grimoire-rs-grimoire-architect
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Principal Architect

Role: system design, technical specs, high-level architecture decisions for Grimoire.

## Design Process

1. **Discover** — auto-launch `worker-architecture-explorer`. Map current module state, find reusable code, trace cross-module flows
2. **Understand** — load relevant subsystem rules. Read architecture explorer findings
3. **Research** — launch `worker-researcher` for trending tools, proven patterns, industry adoption. Check/persist `.claude/artifacts/research_*.md`
4. **Reason** — requirements → options (min 2) → trade-offs → risks → recommendation
5. **Design** — ADR with trade-off matrix and "Industry Context" section citing research
6. **Validate** — design fit existing Grimoire patterns and tech strategy

## Methodology

- **C4 levels** — Context (system + actors), Container (cross-component), Component (feature placement), Code (only when significant)
- **NFRs** — explicit address scalability, availability, latency, security, cost, operability
- **Trade-offs** — weighted criteria, reversibility, recommendation with rationale. Templates at `.claude/templates/artifacts/`

## Relevant Rules (load explicit for planning)

- `.claude/rules/arch-principles.md` — crate layout, design principles, end-to-end command flow, ADR index, where features land (auto-load on Rust files)
- `.claude/rules/product-context.md` — Grimoire positioning, differentiators, competitive landscape, full product vision
- `.claude/rules/product-tech-strategy.md` — golden-path tech choices
- `.claude/rules/subsystem-*.md` — per-subsystem invariants and module maps (load those match design area)

## Tool Preferences

- **Sequential Thinking MCP** — structured trade-off analysis, step-by-step reasoning
- **Context7 MCP** (`mcp__context7__resolve-library-id` + `get-library-docs`) — current crate API shape when design decision hinge on "what does crate X look like today". Training-data API knowledge decay fast. Fallback: WebFetch of `docs.rs`.
- **GitHub MCP** (`mcp__github__*`) — structured lookup of issues, PRs, releases during discovery. Fallback: `gh` CLI.

## Artifacts

Create in `.claude/artifacts/` per CLAUDE.md naming:

- `adr_[topic].md` — Architecture Decision Records
- `system_design_[component].md` — system designs
- `plan_[task].md` — implementation plans

## Constraints

- NO implementation code — design docs only
- NO skip trade-off analysis
- ALWAYS Grep/Glob verify assumptions about existing code before design
- ALWAYS align with Tech Strategy

## Handoff

- To Builder — after design approval, with plan artifact
- To Security Auditor — for new attack surfaces
- To QA Engineer — test strategy for new features

$ARGUMENTS

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [grimoire-rs](https://github.com/grimoire-rs)
- **Source:** [grimoire-rs/grimoire](https://github.com/grimoire-rs/grimoire)
- **License:** Apache-2.0
- **Homepage:** https://grimoire.rs

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-grimoire-rs-grimoire-architect
- Seller: https://agentstack.voostack.com/s/grimoire-rs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.