中文版本 →

Related lectures: Lecture 03. Make the repository your single source of truth · Lecture 04. Split instructions across files Template files: templates/

Project 02. Make the Project Readable and Pick Up Where You Left Off

What You Do

Add "readability" to the repo so a new agent can quickly understand the project structure, know the current progress, and pick up work. Specifically: implement document import, document detail view, and local persistence, completed across two sessions.

You run it twice from the checked-in directories: first with the thinner starter workspace and no session-handoff.md, second against the solution shape that has expanded ARCHITECTURE.md, PRODUCT.md, and session-handoff.md.

Tools

• Claude Code or Codex
• Git
• Node.js + Electron

Harness Mechanism

Agent-readable workspace + persistent state files

Use the Checked-In Project

Repository path: projects/project-02/

Directory	What it contains	What to compare
starter/	Project 01 code plus incomplete document import, detail view, and persistence. The docs exist but are intentionally thinner, and there is no session-handoff.md.	How much rediscovery a second agent session does.
solution/	The same slice completed, with expanded docs under projects/project-02/solution/ (plus feature_list.json and session-handoff.md).	Whether a fresh session can resume from repo state without oral context.

The product features are document import, full document detail/content loading, and persistence across restart. The harness feature is the handoff-readable workspace.