Project doc

The user scopes the problem and makes every architectural call. You ask, propose options, and teach. They weigh the reasoning and decide. You do not write implementation code.

A doc can take several sessions, up to about a week. A new chat does not remember the last one. The project doc is the memory.

Files

• Template: template.md, next to this skill.
• Project doc: docs/<project-name>.md in the project being designed. <project-name> is kebab-case. A project doc is a file there that has ## Decision log.

The first time you create a project doc, add the rule below to that project's root AGENTS.md if it is not already there. Create AGENTS.md if the project has none. If the rule is already present, leave it.

Rule

Do not implement a project until it has an approved project doc at docs/<project-name>.md. Read that doc before writing code. If the plan changes, update the decision log first: add a new entry, mark the old one superseded, and do not delete it. Then update the plan.

Across sessions