Archcore MCP

Archcore CLI — AIコーディングエージェントのためのGitネイティブなコンテキスト

Archcoreは、AIコーディングエージェントのためのGitネイティブなコンテキストレイヤーです。

CLIは、仕様、アーキテクチャ決定、ルール、計画、プロジェクト知識を.archcore/に保持し、コードとともにバージョン管理し、MCPとセッションフックを通じて関連コンテキストをコーディングエージェントに提供します。

CLIとローカルstdio MCPサーバーとして提供されるため、MCP互換のコーディングエージェントは標準ツールを通じてプロジェクトコンテキストを読み書きできます。Claude Code、Cursor、Codex CLI、GitHub Copilot、Gemini CLI、OpenCode、Roo Code、Cline全体で永続的なプロジェクトコンテキストに使用できます。

動作の確認

そのコンテキストは.archcore/、つまりGitでバージョン管理された型付きMarkdownドキュメントから取得され、MCPツールとセッションフックを通じて任意のエージェントに提供されます。

何が変わるか

❌ Archcoreなしの場合

すべてのセッションがゼロから始まります。エージェントは：

• アーキテクチャを推測し、規約を破る
• 既存のロジックを重複させる
• チームがすでに下した決定を再議論する
• 毎回のチャットで同じコンテキストを再説明する必要がある

✅ Archcoreありの場合

決定、ルール、規約が構造化コンテキストとしてGitに保存されます。エージェントは：

• セッション開始時に適用可能な決定とルールを読み込む
• アーキテクチャが指定する場所にコードを配置する
• リポジトリ内の既存のADR、仕様、ルールを尊重する
• 新しい決定を永続的なコンテキストとして記録する — PRでレビュー可能、エージェント間で移植可能

エージェントは推測をやめ、システムに従い始めます。

60秒で始める

curl -fsSL https://archcore.ai/install.sh | bash    # macOS / Linux
cd your-project && archcore init

archcore initは.archcore/をスキャフォールドし、コーディングエージェントを検出して、フックとMCPを設定します。

次にエージェントを開いて、次のように伝えます：

"プライマリストレージにPostgreSQLを使用しています。この決定を記録してください。"

完了です — 今後すべてのセッション、すべてのエージェントで表示される構造化ADRが.archcore/に作成されました。

Windowsの場合：irm https://archcore.ai/install.ps1 | iex。WSL、go install、ソースからのビルドについては、以下のインストール方法または完全なインストールガイドを参照してください。

エージェントとの連携

CLI自体がローカルstdio MCPサーバーであり、MCP互換のすべてのエージェントに対する単一の統合インターフェースです。フックは、エージェントがサポートする場合にセッション開始時のコンテキストを追加します。

archcore initは検出されたエージェントを自動的に設定します。手動で設定するには：

archcore mcp install --agent cursor      # write MCP config for a specific agent
archcore hooks install                   # install session-start hooks for detected agents
claude mcp add --transport stdio archcore -- archcore mcp   # or add the server manually

仕組み

1. 初期化 — archcore initが.archcore/を作成し、エージェント統合をインストールします。
2. 記録 — 決定、ルール、計画、ガイドはYAMLフロントマター付きの型付きMarkdownドキュメントとして保存されます。
3. 再利用 — エージェントは作業中にMCPツールを通じてドキュメントを読み取り、作成、更新、リンクします。フックはセッション開始時にコンテキストを読み込みます。
4. Gitで管理 — コードと同様にコンテキストの変更をレビューし、時間とともに進化させ、ツール間で移植可能に保ちます。

.archcore/
├── settings.json
├── auth/
│   ├── jwt-strategy.adr.md
│   └── auth-redesign.prd.md
├── backend/
│   └── error-wrapping.rule.md
├── incidents/
│   └── connection-pool-exhaustion.cpat.md
└── notifications/
    └── notifications-implementation.plan.md

構造は自由形式です — ドメイン、機能、チームごとに整理できます。ドキュメントのタイプはファイル名（slug.type.md）に含まれます：3つのレイヤーにわたる19タイプ — 知識（ADR、ルール、仕様、ガイド）、ビジョン（PRD、計画、アイデア、要件トラック）、経験（インシデントパターン、反復タスク）。このリポジトリ自身の.archcore/が実例です。

エージェントに依頼する

"認証モジュールに触れる前に、ここに適用される決定とルールは何ですか？"

エージェントが1行でも編集する前に、その領域に関連するADRとルールを読み込みます。

"規約があります：エラーは常にfmt.Errorfと%wでラップする。これをルールにしてください。"

命令的なガイダンス、根拠、良い例/悪い例を含むbackend/error-wrapping.rule.mdを作成します。

"先週、コネクションプール枯渇のインシデントがありました。繰り返さないように文書化してください。"

根本原因分析と予防手順を含むincidents/connection-pool-exhaustion.cpat.mdを作成します。

比較

対象外 — チャットメモリ、プロンプトライブラリ、ワンショットの仕様からコードへの生成。Archcoreは方法論キットではなく、コーディングエージェントのためのリポジトリ真実レイヤーです。

リファレンス

同梱内容：19のドキュメントタイプ、4の関係タイプ、10のMCPツール、4つのエージェント向けフック統合、8つのMCP統合。

---
title: "Use PostgreSQL for Primary Storage"
status: draft
tags: [database, infrastructure]
---

## Context

...

curl -fsSL https://archcore.ai/install.sh | bash

irm https://archcore.ai/install.ps1 | iex

go install github.com/archcore-ai/cli@latest

git clone https://github.com/archcore-ai/cli.git
cd cli
go build -o archcore .

archcore config                    # show all settings
archcore config get <key>          # get a specific value
archcore config set <key> <value>  # set a value

エコシステム

• Archcore Plugin — Claude Code または Cursor をお使いですか？プラグインは CLI と連携します：同じエンジンに加え、スキル、インテントコマンド、ガードレールを備えています。1つの製品、2つのエントリーポイント — CLI 単体で他のすべてのエージェントをカバーします。
• docs.archcore.ai — 完全なドキュメント。
• このリポジトリの .archcore/ — 生きた例：CLI は独自のコンテキストレイヤーで構築されています。

開発

Go 1.25+ が必要です。

go build -o archcore .   # build
go test ./...            # run all tests

リンクとライセンス

• ドキュメント: docs.archcore.ai
• ウェブサイト: archcore.ai
• プラグイン (Claude Code, Cursor): github.com/archcore-ai/archcore-plugin
• 問題報告: github.com/archcore-ai/cli/issues
• ライセンス: Apache 2.0