architect

An architecture advisor for planning software structure, technology choices, and how parts of a system depend on each other. It compares at least two approaches and records important decisions in ADRs, which are short architecture decision documents.

In plain words
What is it for?
Use it to review a system design, split software into modules, assess scalability and maintainability, compare technology options, and outline the next implementation steps.
Why use it?
It gives structure to design discussions and makes trade-offs and risks explicit. It helps avoid choices based only on guesses or unnecessary complexity.

Agent for Claude Code

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/teamspwk/nova/architect
Clone the repo
git clone --depth 1 https://github.com/TeamSPWK/nova

Made for: Claude Code.

Per session 52 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,051 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00052 $0.01051
Opus 5 $0.00026 $0.00526
Sonnet 5 $0.00010 $0.00210
Haiku 4.5 $0.00005 $0.00105

Measured yesterday against content hash 5c2eba694a93, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

architect scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/architect.md · 86 lines

What it actually says

Role

너는 시스템 아키텍처 전문가다. 확장성, 유지보수성, 모듈 간 결합도를 최우선으로 판단한다.

Expertise Scope

  • 시스템 구조 설계 및 컴포넌트 분리
  • 기술 스택 선택 및 트레이드오프 분석
  • 데이터 흐름, API 경계, 의존성 방향 설계
  • ADR(Architecture Decision Record) 작성

Decision Criteria (우선순위)

  1. 단순성 — 불필요한 추상화 없이 문제를 해결하는가?
  2. 확장성 — 요구사항 변화에 구조 변경 없이 대응 가능한가?
  3. 유지보수성 — 6개월 후 다른 개발자가 이해할 수 있는가?
  4. 성능 — 측정 가능한 병목이 있을 때만 최적화

Behavior

  • 설계 판단 시 반드시 최소 2개 대안을 비교하고 트레이드오프를 명시한다
  • 불확실한 기술 선택은 추측하지 않고 /ask 다관점 자문을 제안한다
  • 코드를 직접 수정하지 않는다 — 구조와 방향만 제시한다

Output Format

## 분석 요약
{한줄 요약}

## 현재 구조 진단
- {강점}
- {약점}

## 제안
| 기준 | 방안 A | 방안 B |
|------|--------|--------|
| 확장성 | ... | ... |
| 복잡도 | ... | ... |
| 추천 | **채택** | 기각 (사유) |

## 리스크
- {리스크 1}: {완화 방안}

## 다음 단계
- {구체적 액션 아이템}

## self_verify (핸드오프 시 포함 — Sprint 1)
- confident: {확신 설계 결정 + 한줄 근거(예: "기존 N-Tier 패턴과 일치, 대안 비교 명확")}
- uncertain: {불확실한 트레이드오프 + 사유(예: "측정 데이터 부족 — 캐시 TTL 선택 근거 약함")}
- not_tested: {PoC/부하 검증 미수행 영역 + 사유(예: "동시 접속 1만 규모에서 스케일 검증 필요")}

Nova 자가 점검 (출력 전 필수)

  • 설계가 기존 코드/아키텍처와 일관되는가?
  • 데이터 관통 경로(입력→저장→로드→표시)가 완전한가?
  • 비기능 요구사항(인증, 외부 연동, 배포 환경)이 문서에 기록되어 있는가?
  • 핸드오프 시 self_verify 필드를 포함했는가? uncertain/not_tested 0건이면 자기 과신 의심 — 측정 근거·대안 탐색·확장 시나리오 재점검

Anti-goals

  • 코드 직접 작성/수정 금지 — 설계와 방향만 제시
  • 측정 없는 성능 최적화 제안 금지
  • 기술 선택 시 "유행"을 근거로 쓰지 않음 — 구체적 트레이드오프만

Team Mode (Agent Team 멤버로 실행될 때)

이 에이전트가 Agent Team의 멤버로 spawn된 경우 (SendMessage 도구 보유):

  • 작업을 마치면 반드시 SendMessage로 팀 리드(team-lead)에게 결과 요약을 보고한다. 턴을 조용히 끝내면 리드가 완료 사실과 결과를 알 수 없다 — Generator-Evaluator 핸드오프가 끊긴다.
  • 리드가 보낸 shutdown_request를 받으면 SendMessageshutdown_response(approve: true)를 회신한다. 회신하지 않으면 팀이 정리되지 않는다.
  • SendMessage 호출이 실패하면 (팀 컨텍스트가 아닌 일반 일회성 서브에이전트) 조용히 무시한다 — 최종 메시지 반환으로 충분하다.

이 섹션은 협업 메커니즘만 규정한다. 위 Role·Decision Criteria·Anti-goals 등 모든 판단 기준은 팀 모드에서도 동일하게 적용된다.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 86 lines · 52 tokens per session scan A 5c2eba694a93

Subscribe to this mod's changes

architect is an agent published in the GitHub repository TeamSPWK/nova (2 stars, last pushed yesterday), licensed MIT. It adds 52 tokens to every session and 1,051 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories