惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

美团技术团队
T
The Blog of Author Tim Ferriss
C
Check Point Blog
博客园_首页
J
Java Code Geeks
云风的 BLOG
云风的 BLOG
L
LangChain Blog
小众软件
小众软件
Stack Overflow Blog
Stack Overflow Blog
爱范儿
爱范儿
Vercel News
Vercel News
博客园 - Franky
V
V2EX
IT之家
IT之家
U
Unit 42
N
Netflix TechBlog - Medium
腾讯CDC
Apple Machine Learning Research
Apple Machine Learning Research
Microsoft Azure Blog
Microsoft Azure Blog
罗磊的独立博客
博客园 - 叶小钗
H
Help Net Security
V
Visual Studio Blog
GbyAI
GbyAI

DEV Community

Authentication Security Deep Dive: From Brute Force to Salted Hashing (With Java Examples) Why AI Systems Don’t Fail — They Drift Spilling beans for how i learn for exam😁"Reinforcement Learning Cheat Sheet" I Replaced Chrome with Safari for AI Browser Automation. Here's What Broke (and What Finally Worked) How Python Borrows Other People's Work The $40 Architecture: Processing 1 Billion API Requests with 99.99% Uptime Vibe Coding: A Workflow Guide (From Zero to SaaS) Most webhook security guides protect the wrong side. The scary part is delivery. Headless CMS for TanStack Start: Build a Blog with Cosmic EU Age Verification App "Hacked in 2 Minutes" — What Actually Happened Comfy Cloud’s delete function does not actually remove files Running AI Models on GPU Cloud Servers: A Beginner Guide Event-driven media intelligence with AWS Step Functions and Bedrock I scored 500 AI prompts across 8 quality dimensions — here's what broke How to Call Google Gemini API from Next.js (Free Tier, No Backend Needed) The Portal Protocol: Reclaiming Human Connection in the Age of AI How to Fix Your Team's Scattered Knowledge Problem With a Self-Hosted Forum Intro to tc Cloud Functors: A Graph-First Mental Model for the Modern Cloud Designing Multi-Tenant Backends With Both Ownership and Team Access I Built a Neumorphic CSS Library with 77+ Components — Here's What I Learned PostgreSQL Performance Optimization: Why Connection Pooling Is Critical at Scale Cómo construí un SaaS multi-rubro para gestionar expensas en Argentina con FastAPI + Vue 3 🚀 I Built an Ethical Hacking Scanner Tool – Open Source Project I Replaced /usage and /context in Claude Code With a Single Statusline A Pythonic Way to Handle Emails (IMAP/SMTP) with Auto-Discovery and AI-Ready Design I Collected 8.9 Million Polymarket Price Points — Here's What I Found About How Markets Really Move EcoTrack AI — Carbon Footprint Tracker & Dashboard Everyone's Using AI. No One Agrees How. 5 self-hosted ebook managers worth trying in 2026 Building Your First AI Agent with LangChain: From Chatbot to Autonomous Assistant
APC: One Context, One Name
Manuel Bruña · 2026-06-15 · via DEV Community

Every AI coding agent wants project context. Claude Code, Codex, Cursor, OpenCode, Windsurf, and similar agentic development tools all need the same basic facts: how the repository is structured, which commands matter, what rules should be followed, which agents exist, and which project knowledge should survive beyond one chat.

The problem is not that tools want context. The problem is that each tool tends to invent its own branded home for it.

The infographic behind this post shows the core APC thesis in one picture: project meaning should not be trapped in .claude/, .cursor/, .codex/, or any other vendor-specific folder. It should have one neutral name: .apc/.

The concrete thesis

APC is not another prompt dump. APC is a filesystem convention for durable, project-owned agent context. APX is the local runtime/tooling layer that makes that context useful in daily work while keeping runtime state outside the repository.

That split matters.

A repository should be able to say: "these are the agents, rules, skills, MCP hints, and curated memories that belong to this project." Any compatible agent runtime should be able to read that without asking the team to duplicate the same meaning into five different folders.

At the same time, a repository should not contain raw sessions, private transcripts, local caches, or secrets. Those belong to the runtime.

From branded silos to a shared standard

Without a shared convention, teams end up with parallel context trees:

.claude/
.cursor/
.codex/
.opencode/
.windsurf/

Each folder may contain useful instructions. But when the same repository rule is copied into multiple tool-specific locations, the real source of truth becomes unclear.

Did the team update Claude but forget Cursor? Did Codex read the newer rule or the stale one? Are MCP expectations documented once, or scattered through local config files?

APC turns that into a simpler model:

AGENTS.md        # root project contract
.apc/            # structured project context

AGENTS.md gives compatible tools a broad root contract: repository rules, stack notes, commands, and guidance. .apc/ carries structured project context: project metadata, agent definitions, reusable skills, rules, durable plans, and MCP hints that are safe to share.

The project/runtime boundary

The right side of the infographic shows the most important design constraint: APC is for durable project meaning, not runtime state.

Commit this kind of information:

.apc/project.json
.apc/agents/<slug>.md
.apc/skills/
.apc/rules/
.apc/plans/
.apc/mcps.json   # no secrets

Keep this outside APC:

raw sessions
conversation transcripts
local caches
private memory
API keys and credentials

APX follows that boundary. A project is identified by AGENTS.md plus .apc/project.json, while APX stores runtime data under ~/.apx/projects/<id>/. That lets the project definition travel with the repository, while local execution history stays on the machine where it belongs.

Why the neutral name matters

Names shape behavior. If project context lives under .claude/, people treat it as Claude-specific. If it lives under .cursor/, people treat it as editor-specific. If every runtime owns its own folder, teams keep maintaining the same project contract many times.

.apc/ says something different: this context belongs to the project.

That means a future-compatible runtime can consume APC directly, project it into its own internal format, or use APX as a reference runtime today. The goal is not to delete every tool folder immediately. The goal is to stop making vendor folders the only source of truth for shared project meaning.

Practical rule

When deciding where a file belongs, ask one question:

Would this still be useful if I switched from one AI coding agent to another?

If yes, it probably belongs in AGENTS.md or .apc/.

If no, it probably belongs in runtime storage such as ~/.apx/, ~/.codex/, .cursor local state, or another tool-owned location.

APC gives the project one context and one name. APX keeps the daily runtime work local, private, and operational.