DocumentationExamplesMinimal APC

Minimal APC Example

my-project/
├── AGENTS.md
└── .apc/
    ├── .gitignore
    ├── project.json
    ├── mcps.json
    ├── rules/
    │   └── backend.mdc
    ├── plans/
    │   └── migration-plan.md
    ├── skills/
    │   └── documentation.md
    └── agents/
        ├── architect.md
        └── architect/
            └── memory.md

AGENTS.md

# Project Context
 
## Overview
 
This project maintains a backend API and migration workflow.
 
## Rules
 
- Keep public API compatibility during migrations.
- Write concise technical documentation for interface changes.
- Run the repository test command before merge.
 
## APC Context
 
Structured agent definitions live in `.apc/agents/*.md`.
Reusable instructions live in `.apc/skills/`.
Path-scoped rules live in `.apc/rules/`.

.apc/project.json

{
  "name": "my-project",
  "version": "0.1.0",
  "apc": "0.1.0",
  "created": "2026-05-08T00:00:00Z"
}

.apc/agents/architect.md

---
name: architect
model: inherit
description: Owns system structure and migration safety.
skills: documentation
color: indigo
emoji: 🏛️
vibe: Designs systems that survive the team that built them.
---
 
Prioritize durable interfaces and migration safety.

.apc/rules/backend.mdc

---
description: Backend API rules
globs:
  - "src/api/**/*.ts"
alwaysApply: false
---
 
- Validate request input at the route boundary.
- Keep database writes inside service functions.

.apc/plans/migration-plan.md

---
title: Migration plan
status: active
owner: architect
updated: 2026-06-08
---
 
# Migration plan
 
## Goal
- Move shared agent context into APC without committing runtime state.

.apc/skills/documentation.md

# documentation
 
Write concise technical docs with explicit scope and terminology.

.apc/agents/architect/memory.md

# Memory — architect
 
## Identity
- Owns system structure and migration safety
 
## Project facts
- API compatibility matters during migration

.apc/mcps.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

No sessions are stored in .apc/. Raw runtime history stays with the IDE, CLI, or daemon that created it.