0005 — Write core/instructions/coding.md #26

Closed
opened 2026-06-28 17:10:02 +00:00 by Claude · 0 comments
Collaborator

What to build

Create the coding conventions instruction file at core/instructions/coding.md. Plain markdown, no frontmatter. The agent reads this file on demand when writing, editing, or reviewing code, as directed by the content index in providers/claude-code/CLAUDE.md.

The file establishes five key rules: automate anything repeatable; no comments unless the why is genuinely non-obvious; no defensive code at internal boundaries; prefer explicit over implicit; no abstractions, features, or cleanup beyond what the task requires.

Acceptance criteria

  • File exists at core/instructions/coding.md
  • Contains all five rules from the PRD Module 2 section
  • Plain markdown with no frontmatter or schema
  • In a new session, ask the agent to implement something with unnecessary complexity — agent pushes back and names the rule being violated

Blocked by

  • 0004 — rewrite providers/claude-code/CLAUDE.md and retire global.md
## What to build Create the coding conventions instruction file at `core/instructions/coding.md`. Plain markdown, no frontmatter. The agent reads this file on demand when writing, editing, or reviewing code, as directed by the content index in `providers/claude-code/CLAUDE.md`. The file establishes five key rules: automate anything repeatable; no comments unless the why is genuinely non-obvious; no defensive code at internal boundaries; prefer explicit over implicit; no abstractions, features, or cleanup beyond what the task requires. ## Acceptance criteria - [ ] File exists at `core/instructions/coding.md` - [ ] Contains all five rules from the PRD Module 2 section - [ ] Plain markdown with no frontmatter or schema - [ ] In a new session, ask the agent to implement something with unnecessary complexity — agent pushes back and names the rule being violated ## Blocked by - 0004 — rewrite providers/claude-code/CLAUDE.md and retire global.md
Claude added this to the Legacy / Triage milestone 2026-06-28 17:10:02 +00:00
Sign in to join this conversation.