Topcode — AI skill for Claude Code

TopCode

[中文](README.zh.md) | **English**

The next-generation CLI agent framework — model-agnostic, context-entropy-resistant, built on **State Manifold Projection**.

Underlying paradigm: **Topological Wavefront Execution** · Positioning: a direct competitor to Claude Code.

**Current version: v0.7.0** · License: AGPL-3.0 · Runtime: Node.js + NestJS + TypeScript

---

Table of Contents

• Philosophy: Why We Overthrow the Old Paradigm
• The Six Paradigm Pillars
• Core Features
• System Architecture
• Quick Start
• CLI Usage
• Action Routing Protocol
• Configuration
• State Files & Memory System
• Directory Structure
• Evaluation System
• Roadmap & Milestones
• Documentation Map
• Development Rules

---

Philosophy: Why We Overthrow the Old Paradigm

Every existing CLI agent shares one old axiom:

"An agent's state = a one-dimensional tape of conversation tokens."

This produces four inevitable pathologies:

1. Irreversible context entropy — compression means loss, loss means amnesia, amnesia means repeating mistakes;
2. One-dimensional time — a serial while-loop; trial-and-error cost = wall-clock time × serial iterations;
3. No world model — knowledge has no confidence structure; every re-observation is paid for again;
4. No intelligence accumulation — the hundredth identical operation burns the same tokens as the first.

TopCode's new axiom:

**An agent's state is an evolvable, verifiable, projectable State Manifold. The LLM is not the container of state — it is a state-transition operator on the manifold. Context is not a log; it is a view computed on demand from the manifold.**

Full argumentati