Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
.tmp/
31 changes: 2 additions & 29 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,41 +5,14 @@ This file governs how Claude Code works in this repository. These rules are mand
## Reference Documents

- **SPEC.md**: the authoritative specification. All implementation decisions come from this document.
- **PLAN.md**: the step-by-step implementation plan. Work proceeds in plan part order.

## Plan Execution Rules

1. **Follow PLAN.md top-to-bottom.** Do not skip parts. Do not start a later part before the current part is fully validated.

2. **Validate before moving on.** Every plan part has a Validation section with specific commands and checks. Run every validation step. Only proceed to the next part when all validation checks pass.

3. **If validation fails:**
- Do NOT silently fix and move on.
- Record the failure in the part's **Failure Log** section in PLAN.md. Include:
- The exact command that failed
- The full error output
- A brief description of the root cause
- What was done to fix it
- Fix the issue, then re-run all validation steps for the current part.
- Update the Failure Log with the resolution.

4. **Update PLAN.md continuously.** As work progresses:
- Check off completed items with `[x]`
- Mark in-progress items with `[~]`
- Mark failed items with `[!]` and add details to the Failure Log
- The plan must always reflect the current true state of the implementation.

## Git and Commit Rules

1. **A git repository is already initialized.** All work happens on the default branch.

2. **Every plan part must end with a commit.** Commit even if validation initially failed — the failure and fix should both be in the history. The commit message is specified in each plan part.

3. **No major changes without a commit first.** Before starting any significant refactor, rewrite, or new part, ensure the current state is committed. This guarantees work can always be restored.

4. **Commit granularity:** one commit per plan part. Do not squash multiple parts into one commit. Do not split a single part across multiple commits unless a mid-part checkpoint is needed to preserve work before a risky change.
2. **No major changes without a commit first.** Before starting any significant refactor or rewrite, ensure the current state is committed. This guarantees work can always be restored.

5. **Never amend previous commits.** Always create new commits. If something from a previous part needs fixing, fix it in the current part and note it in the Failure Log.
3. **Never amend previous commits.** Always create new commits.

## Code Quality Standards

Expand Down
Loading
Loading