메뉴
Create or update ARCHITECTURE.md with system components, data flows, and ADRs
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | design |
| description | Create or update ARCHITECTURE.md with system components, data flows, and ADRs |
Maintain the living architecture document for this project. Creates ARCHITECTURE.md if absent; updates it in place if it exists.
If ARCHITECTURE.md exists, read it in full. If absent, start from a blank structure.
Also read AGENTS.md for project name and technology context.
If invoked with an argument, treat it as a description of the system or a specific change to make.
If invoked with no argument, display the current architecture and ask:
What would you like to change? (add/update component, record a decision, describe a data flow, etc.)
Apply the changes to produce an updated ARCHITECTURE.md with all five sections present:
System Overview — 2–3 sentences describing what the system does and its outer boundaries.
Components — One subsection per component, keyed by a stable slug (e.g. auth-service). Each subsection:
### auth-service
- **Responsibility:** Handles user authentication and session management
- **Interface:** REST `/auth/*` endpoints; emits `user.login` events
- **Depends on:** user-db, email-service
Data Flows — Key scenarios as numbered steps, one subsection per flow:
### User login
1. Client POSTs credentials to `auth-service /auth/login`
2. `auth-service` validates against `user-db`
3. On success, issues JWT and publishes `user.login` to event bus
External Dependencies — Table of third-party services, libraries, or infrastructure:
| Dependency | Purpose | Version constraint |
|---|---|---|
| PostgreSQL | Primary datastore | >= 15 |
ADR Log — Append-only. Never remove or edit existing rows. New decisions go at the bottom:
| # | Decision | Date | Status |
|---|---|---|---|
| ADR-001 | Use PostgreSQL over SQLite for multi-user writes | 2026-05-15 | Accepted |
ADR statuses: Proposed | Accepted | Superseded | Rejected
Write the updated content to ARCHITECTURE.md. Preserve all existing ADRs verbatim.
Output:
/story)Don't:
stories/*.mdReview a pull request or pending changes. Performs a focused code review against the current branch's diff (or staged diff if invoked pre-commit), surfacing correctness bugs, missing tests, style violations, and unclear naming. Use when the user asks to "review this", "review the PR", "code review", or before commits/PRs.
Complete a security review of pending changes on the current branch. Focuses on injection, authn/authz, secrets, SSRF, deserialisation, insecure defaults, and supply-chain risk. Use when the user asks to "security review", "security audit", "check for vulns", or before raising a PR.
Pre-commit gate (fmt + clippy + test) then create a conventional commit with explicit file staging.
Format Rust code with rustfmt and report what changed.
Full TDD loop — plan, branch, write code + tests, fmt, clippy, test, review, commit.
View the story board grouped by status, with optional filters