Skeleton First Code SKILL

Skeleton-First Code

**A workflow contract that makes AI coding agents build large projects the way software should be built: one module, one stage, one timestamped log entry at a time.**


**[🇬🇧 English](./README.md)** · **[🇨🇳 简体中文](./README_CN.md)**

---

The problem: why agents fail at big projects

Give a capable LLM agent a real project and, once the context grows long, it fails in three predictable ways:

#	Failure	What it looks like
1	Long-context amnesia	Context compaction silently deletes the plan and early decisions. The agent resumes "from vibes": re-implements finished modules, contradicts settled choices, quietly drops goals it can no longer see.
2	Blind development	Writes the whole project as one impulse — code before architecture, features before tests. Declares "done" after a single green test tool. Fixes five modules at once and breaks them all. Plans 20 modules on day one, implements zero.
3	Unmaintainable output	A week later nobody (including the same agent) can answer: why does this exist, who touches what, what changed and when? Monolith files, god modules, no decision trail, no resume point. A project that cannot be resumed cannot be maintained.

The root cause is structural, not intelligence: **an agent's context is volatile memory, but software development needs persistent memory and a scheduling discipline.**

The fix: Skeleton-First Code

This repository is a **SKILL.md workflow contract** (Claude Code / OpenCode / any agent that loads markdown instructions) that turns every code-writing task into a state machine the agent can never silently exit:

**Three pillars**

1. Persistent Memory — every decision lives on disk: a README specification, plans/ planning logs, logs/ development logs.