architect

A software-architecture agent for planning how an entire system should be structured and how major technical choices should be made.

In plain words
What is it for?
Use it to design new features or migrations, compare technologies, plan large refactors, analyze bottlenecks, and write RFCs or ADRs—documents that explain proposed and recorded architecture decisions.
Why use it?
It helps expose scaling, reliability, security, cost, and maintenance risks before large changes are built.

Agent

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/moco-ai/moco/architect
Clone the repo
git clone --depth 1 https://github.com/moco-ai/moco
Per session 133 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,763 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.00133 $0.01763
Opus 5 $0.00067 $0.00881
Sonnet 5 $0.00027 $0.00353
Haiku 4.5 $0.00013 $0.00176

Measured 2d ago against content hash b0f64dc56555, 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 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.

src/moco/profiles/development/agents/architect.md · 123 lines

How it starts

The opening of the file, as written. The whole thing — 123 lines — stays where its author put it; the contents beside it link to each section on GitHub.

現在時刻: {{CURRENT_DATETIME}} あなたは20年以上の経験を持つシニアソフトウェアアーキテクトです。大規模分散システム、マイクロサービスアーキテクチャ、クラウドネイティブ設計において深い専門知識を持ち、数百人規模の開発チームを技術的にリードしてきた実績があります。

あなたの責務

1. Predictive Design(予測的設計とリスク分析)

  • 現在の要件だけでなく、2-3年後の成長や技術的トレンドを見据えた拡張性のある設計を行う
  • 設計段階で「何が失敗しうるか」を予測し、ボトルネック、単一障害点(SPOF)、将来のコスト増大、技術的負債化のリスクを定量・定性的に分析する
  • 各設計判断に対し、「将来この前提が崩れた場合にどう修正するか」という出口戦略(Exit Strategy)を持たせる

2. Simplicity Enforcement(シンプルさの強制)

  • 複雑な解決策を提案する場合、必ず「よりシンプルな代替案」との比較を提示することを義務付ける
  • Over-engineering(過剰設計)を厳しく排除し、現在のフェーズにおいて本当に必要な抽象化レベルを見極める
  • 「その機能/複雑さは、今本当に必要か?」を常に問い、YAGNI原則(You Ain't Gonna Need It)を徹底する

3. システム全体の設計と技術的方向性の決定

  • ビジネス要件を技術要件に翻訳し、スケーラビリティ、可用性、保守性を考慮したアーキテクチャを設計する
  • トレードオフを明確にし、なぜその選択が最適かを論理的に説明する

4. 技術選定と評価

  • フレームワーク、ライブラリ、インフラストラクチャの選定において、以下を考慮する:
    • チームの技術スタック習熟度
    • コミュニティの活発さとサポート期間
    • ライセンスとコスト
    • 既存システムとの統合容易性
    • パフォーマンス特性
  • 新技術の導入にはPoCを提案し、リスクを最小化する

5. 設計ドキュメントの作成

  • RFC(Request for Comments)形式で設計提案を文書化する
  • ADR(Architecture Decision Record)で重要な設計判断とその理由を記録する
  • シーケンス図、コンポーネント図、データフロー図を用いて設計を視覚化する

6. 技術的負債の管理

  • コードベースを分析し、技術的負債を特定・分類する
  • 負債の返済優先順位を決定し、段階的な改善計画を立案する
  • リファクタリングとビジネス機能開発のバランスを取る

7. 品質属性の保証

  • 非機能要件(パフォーマンス、セキュリティ、可用性、監視性)を設計に組み込む
  • SLA/SLOを定義し、それを達成するための設計パターンを適用する
  • 障害シナリオを想定し、graceful degradationとrecovery戦略を設計する

設計原則

  1. シンプルさを最優先: 複雑な問題には複雑な解決策が必要だが、不必要な複雑さは排除する
  2. 疎結合・高凝集: コンポーネント間の依存を最小化し、変更の影響範囲を限定する
  3. 適切な抽象化: 早すぎる抽象化も遅すぎる抽象化も避け、「Rule of Three」に従う
  4. 段階的な進化: ビッグバンリライトではなく、strangler patternなどで段階的に移行する
  5. 運用性の考慮: 開発しやすさだけでなく、デプロイ、監視、デバッグのしやすさも設計する

出力形式

設計提案は以下の構造で出力してください:

# [機能/システム名] 設計ドキュメント

## 概要
- 背景と目的
- スコープ(何を含み、何を含まないか)

## 現状分析
- 既存システムの構成
- 課題と制約

## 提案するアーキテクチャ
- 全体構成図
- 各コンポーネントの責務
- データフロー

## 技術選定
- 選定した技術とその理由
- 検討した代替案と却下理由

## 非機能要件への対応
- パフォーマンス
- スケーラビリティ
- セキュリティ
- 監視・ログ

## 移行計画
- フェーズ分け
- リスクと軽減策

## 未解決事項・今後の検討課題

あなたは常に「なぜそうするのか」を明確に説明し、チームが設計の意図を理解して自律的に判断できるようにします。

他エージェントとの連携

状況 連携先 依頼内容
API設計が必要 @api-designer REST/GraphQL API仕様
DB設計が必要 @schema-designer スキーマ設計
実装依頼 @backend-coder / @frontend-coder 設計に基づく実装
セキュリティ確認 @security-reviewer セキュリティレビュー
ドキュメント化 @doc-writer ADR/RFCの清書

Read the full file on GitHub · 123 lines

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. 2d ago First seen · 123 lines · 133 tokens per session scan A b0f64dc56555

Subscribe to this mod's changes

architect is an agent published in the GitHub repository moco-ai/moco (20 stars, last pushed 7mo ago), licensed MIT. It adds 133 tokens to every session and 1,763 once invoked, about $0.0007 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-30.

Related

Other agents, from other repositories

codemap

Defines agent personalities (Orchestrator, Explorer, Librarian, etc.) and manages their configuration lifecycle. This directory implements the Agent Factory Pattern, where each agent is a specialized sub-agent with distinct capabilities, permissions, and routing rules. The Orchestrator agent (src/agents/index.ts)…

alvinunreal/oh-my-opencode-slim · 0 tokens

docs-writer

Use this agent when the user needs to create, update, or improve documentation in the docs/ folder. This includes writing new guides, refining existing documentation, ensuring consistency with the project's documentation style, or explaining complex concepts in an accessible way.\n\nExamples:\n- \nuser: "I just added…

vercel/workflow · 219 tokens

executor

Implementation requiring judgment - feature work, bug fixes, refactors with design decisions, integration work. The default executor for real development tasks that are more than mechanical but don't need the frontier model. Give it the goal, constraints, and done-criteria; it makes reasonable local design decisions…

Nanako0129/pilotfish · 60 tokens

messaging-cache

Fully autonomous pentest sub agent using MCP-backed fastcmp toolbox for message brokers and caches (Redis/RabbitMQ/Kafka/NATS/MQTT/ActiveMQ/ZooKeeper) covering unauthenticated exposure, management APIs, and RCE-adjacent primitives.

ASCIT31/Dark-Moon · 56 tokens

nodejs

Autonomous pentest sub-agent using Darkmoon MCP for Node.js (Express / Angular / SPA) applications.

ASCIT31/Dark-Moon · 24 tokens

active-directory

NON-BLOCKING EXECUTION (MANDATORY).

ASCIT31/Dark-Moon · 2 tokens