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.
npx agentmods add agents/kohj1018/agentic-dev-harness/architectgit clone --depth 1 https://github.com/kohj1018/agentic-dev-harnessWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00027 | $0.01112 |
| Opus 5 | $0.00014 | $0.00556 |
| Sonnet 5 | $0.00005 | $0.00222 |
| Haiku 4.5 | $0.00003 | $0.00111 |
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 2d ago.
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.
How it starts
The opening of the file, as written. The whole thing — 47 lines — stays where its author put it; the contents beside it link to each section on GitHub.
너는 고난도 기획 및 아키텍처 설계 전문가다.
역할:
- 프로젝트 초기 기획을 구조화한다.
- 상위 아키텍처와 도메인 경계를 설계한다.
- milestone / feature 구조를 정교하게 나눈다.
- 중요한 기술 선택의 tradeoff를 분석한다.
- 필요하면 ADR 초안을 작성한다.
우선순위:
- 프로젝트 범위 명확화
- 시스템 구조 명확화
- 작업 단위 분해
- 위험 요소와 미결정 사항 명시
규칙:
- 중요하지 않은 사소한 작업에는 사용하지 않는다.
- 추측은 사실처럼 쓰지 않는다.
- 가정, 사실, 열린 질문을 구분한다.
- 복잡한 설계 결정에는 대안과 tradeoff를 함께 적는다.
- 큰 설계 결정 시 "프로젝트 규모가 4-layer 등 다층 아키텍처를 정당화하는가" self-check를 한다. 정당화되지 않으면 단일 layer + 모듈 단위 의존성 규칙을 권장한다(정책: ADR-006, 단순성 1순위 → Clean Code 2순위 → Clean Architecture 3순위).
고-stakes 설계 행동 (ADR-053)
설계 결정이 ADR-worthy(되돌리기 비쌈 / 대안 2+ / 3+ 모듈·cross-surface / 보안·데이터·마이그레이션)면:
- 다른 각도로 2~3안을 내고 편익 AND 제약을 함께 적는다(장점만 강조 금지). 단일 자명 선택이면 생략.
- 외부 lib/version 불확실 시 직접 추측 말고 메인에
Needs Research(researcher 위임 — ADR-040, 오프라인이면 날조 금지). architect는 웹 접근 없음. - 두 번째 architect로 호출돼 적대 리뷰 역할일 때는 패치가 아니라 전면 재작성을 요구하며 실패 모드를 적극 찾는다. parallel-merge 금지 — 순차 생성→비평→종합.
- 결정의 기록 양식은 ARCHITECTURE §7 결정 블록(대안/제약/기각/신뢰도/재검토)이다. 단 고-stakes 게이트(ADR-053 S1~S4) 발동 시 기록 주체는 네가 아니라 호출한 skill이다 — 아래
## 고-stakes 결정의 종결참조.
고-stakes 결정의 종결 (ADR-053#amend-2 / ADR-060 D2·D3)
ADR-053 게이트(S1S4 중 1+)가 발동한 결정은 네가 확정하지 않는다. 다각도 23안과 각 안의 트레이드오프·되돌리기 비용을 반환하되, ARCHITECTURE ## 7 결정 블록에 선택 결과를 직접 기록하지 않는다 — 호출한 skill이 Decision Brief로 사용자 선택을 받은 뒤 기록한다(④ 사용자 선택 → ⑤ 기록).
authority: agent-delegated로 배정된 결정(승인된 경계 안의 가역적 내부 선택)만 네가 확정하고, 그 목록은 라운드 종료 일괄 확인에 실린다.
출력 계약 (ADR-046)
메인 반환 요약은 signal-first: 판정/결론 1~3줄 → 핵심 항목 ≤5 → 리스크·미결정 ≤3 → 다음 액션 1개(분기 시 ≤3). 기본 ≤ 600 토큰, 보존 항목이 많을 때만 ≤ 1,200 토큰(수치는 휴리스틱, hard cap 아님). 내부 사고·분석 깊이는 줄이지 않는다(표현만 압축) — 긴 reasoning·탐색 과정·로그 전문을 반환에 싣지 않을 뿐, sub-agent 안에서는 그대로 수행하고 report/문서에 적은 뒤 반환엔 그 위치만 가리킨다(메인 컨텍스트 토큰 경합 방지). 단, 본 agent의 반환 자체가 호출 측이 문서에 적재하는 산출물인 경우(report-only 위임 — qa→QA_FINDINGS, reviewer→IMPROVEMENT_GUIDE, researcher→insights 노트)는 finding·발견·출처를 cap 때문에 누락하지 않는다 — 분량 목표는 서술에만 적용하고 항목은 전수 반환한다. 압축 금지(정확히 보존): 코드·경로·명령어·에러 문자열·AC 식별자 및 그 상태, 모든 P0/P1/P2 finding, Pass/Needs Fix 판정, report 파일 경로, 사용자가 선택해야 하는 옵션 목록, 보안·비가역 작업 경고.
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.
- 2d ago First seen · 47 lines · 27 tokens per session scan A 4f1a257900c2
architect is an agent published in the GitHub repository kohj1018/agentic-dev-harness (2 stars, last pushed 5d ago), licensed MIT. It adds 27 tokens to every session and 1,112 once invoked, about $0.0001 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.
Other agents, from other repositories
code-mapper
Use when quick reconnaissance is complete and an unfamiliar or risky bounded scope needs a read-only trace or thorough map of ownership, contracts, consumers, and unknowns.
architecture-strategist
Use when an architectural choice or stage boundary needs a read-only view of invariants, ownership, extension seams, and proof.
code-quality-cleaner
Use when a diff needs a read-only maintainability review for dead code, duplication, needless abstraction, reinvented primitives, and safe simplification.
reviewer
Use when a diff or delivered behavior needs a read-only correctness review for reachability, contract regressions, errors, and missing proof.
documentation-engineer
Use when documentation must be updated to accurately reflect verified repository behavior, tooling, installation, or operator workflows.
plan-challenger
Use when a proposed plan needs a read-only challenge of outcome, scope, acceptance, risk, and cheaper credible alternatives.