Archcore MCP

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

Archcoreは github.com/archcore-ai/archcore に移転しました。 このリポジトリはアーカイブされています。CLIは現在、そのリポジトリ内の cli/ にプラグインの隣にあります。v0.10.1以降のすべてのリリースは archcore-ai/archcore/releases で公開されています。 macOS、Linux、WSLでは curl -fsSL https://archcore.ai/install.sh | bash で、Windowsでは irm https://archcore.ai/install.ps1 | iex でインストールまたは更新してください。このリポジトリからインストールされたバイナリ（v0.8.7以前）は自動更新されなくなりました。新しいチャネルに移行するには、インストーラーを一度実行してください。問題報告は archcore-ai/archcore/issues へ。

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を配線します。

次にエージェントを開いて、こう言います：

"We're using PostgreSQL for primary storage. Record this decision."

完了です — これで .archcore/ に構造化されたADRが作成され、将来のすべてのセッション（どのエージェントでも）がそれを参照します。

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つのレイヤーにわたる23タイプ — 知識（ADR、ルール、仕様、ガイド）、ビジョン（PRD、計画、アイデア、要件トラック）、経験（インシデントパターン、反復タスク）。このリポジトリ自身の .archcore/ が実用的な例です。

エージェントに尋ねる

"Before I touch the auth module, what decisions and rules apply here?"

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

"We have a convention: always wrap errors with fmt.Errorf and %w. Make this a rule."

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

"Last week we had a connection-pool exhaustion incident. Document it so we don't repeat it."

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

比較

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

リファレンス

同梱されているもの：23のドキュメントタイプ、7の関係タイプ、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プラグイン — 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/plugin
• イシュー: github.com/archcore-ai/cli/issues
• ライセンス: Apache 2.0