v2.1.1 - Failure Log convention in the init prompts

This commit is contained in:
jparkerweb committed 2026-08-12 13:54:43 -07:00
1 parent ca1e137a54
commit 483c3055b2
10 files changed
+220 -16

No files matched your search

@@ -47,7 +47,14 @@ CLAUDE.md gets a special template because Claude Code auto-loads it — the `CRI
**CRITICAL — MANDATORY FIRST STEP: You MUST read [AGENTS.md](./AGENTS.md) before responding to ANY user message, including simple questions. Do NOT skip this step regardless of how trivial the request appears. No exceptions.**
See AGENTS.md for full project documentation: commands, architecture, environment, testing, deployment, and .agents-docs/ section details.
See AGENTS.md for complete project documentation including:
- Development commands and setup
- Architecture overview
- Environment variables
- Testing patterns
- Deployment guides
- Keeping this file current / Failure log
- Section details in .agents-docs/
This file exists for Claude Code auto-loading. All AI coding agents should reference AGENTS.md.
```
@@ -59,7 +66,14 @@ Use title and path from the detection table:
```markdown
# [Title]
See [AGENTS.md]([Path]) for full project documentation: commands, architecture, environment, testing, deployment, and .agents-docs/ section details.
See [AGENTS.md]([Path]) for complete project documentation including:
- Development commands and setup
- Architecture overview
- Environment variables
- Testing patterns
- Deployment guides
- Keeping this file current / Failure log
- Section details in .agents-docs/
```
**For directory configs** (`.cursor/rules/`, `.windsurf/rules/`): Delete existing `.md` files, create single `reference.md`.
+3 -3
View File
@@ -55,9 +55,9 @@ Check AGENTS.md for a `## Keeping this file current` section at the end of the f
```
## Keeping this file current
The `Failure log` section below is a recording of mistakes make by previous AI Agents while working with this code base.
The `Failure log` section below is a recording of mistakes made by previous AI Agents while working with this code base.
When you make a mistage, get corrected, or discover something about this codebase that wasn't written down:
When you make a mistake, get corrected, or discover something about this codebase that wasn't written down:
1. Add one line to the `Failure log` below, in the imperative, describing the correct behaviour.
2. Keep it specific to this repo. General advice belongs nowhere.
@@ -216,7 +216,7 @@ Check for other AI agent config files (`CLAUDE.md`, `GEMINI.md`, `.cursorrules`,
Read references/ai-agent-file-sync.md
> Fallback: for each detected file, offer Yes/Select/No to replace it with a pointer to AGENTS.md (warn when a file >10 lines has custom content that would be replaced). `CLAUDE.md` gets a special template opening with a `CRITICAL — MANDATORY FIRST STEP` directive to always read `AGENTS.md` (Claude Code auto-loads it); all other files get a short "See AGENTS.md for full project documentation" pointer using the correct relative path (`./`, `../`, or `../../` by location). For directory configs (`.cursor/rules/`, `.windsurf/rules/`), delete existing `.md` files and create a single `reference.md`.
> Fallback: for each detected file, offer Yes/Select/No to replace it with a pointer to AGENTS.md (warn when a file >10 lines has custom content that would be replaced). `CLAUDE.md` gets a special template opening with a `CRITICAL — MANDATORY FIRST STEP` directive to always read `AGENTS.md` (Claude Code auto-loads it); all other files get a "See AGENTS.md for complete project documentation including:" pointer with the same bullet list, using the correct relative path (`./`, `../`, or `../../` by location). For directory configs (`.cursor/rules/`, `.windsurf/rules/`), delete existing `.md` files and create a single `reference.md`.
---
+3 -3
View File
@@ -58,14 +58,14 @@ These sections must remain fully inline in AGENTS.md (never split to separate fi
### Failure Log section template
When creating or modifying `AGETNS.md`, always ensure this section is included at the end:
When creating or modifying `AGENTS.md`, always ensure this section is included at the end:
```
## Keeping this file current
The `Failure log` section below is a recording of mistakes make by previous AI Agents while working with this code base.
The `Failure log` section below is a recording of mistakes made by previous AI Agents while working with this code base.
When you make a mistage, get corrected, or discover something about this codebase that wasn't written down:
When you make a mistake, get corrected, or discover something about this codebase that wasn't written down:
1. Add one line to the `Failure log` below, in the imperative, describing the correct behaviour.
2. Keep it specific to this repo. General advice belongs nowhere.