Skip to content

AGENTS.md

Latest commit

 

History

History
51 lines (42 loc) · 2.09 KB

AGENTS.md

File metadata and controls

51 lines (42 loc) · 2.09 KB
Raw

AGENTS.md

The Workflow

This repository follows a strict execution workflow.

  1. Continue building without waiting unless:
  • There is a hard blocker.
  • Input is 100% required and not already defined in PLAN.md.
  • The full plan is complete.
  • PRs must target main and include a short summary plus the verification commands that were run.
  1. Maintain a live checkpoint file:
  • File: CHECKPOINT.md.
  • Update it on every codebase file change batch.
  • If a single file is edited multiple times, add one checkpoint update for that edit.
  • Each checkpoint entry must include:
    • past action (what was done),
    • present action (what is being done now),
    • future action (what is next),
    • current phase/block/section from CHECKLIST.md,
    • changed files list.
  1. Build from checklist:
  • File: CHECKLIST.md.
  • It must be derived from PLAN.md.
  • It is the source-of-truth execution order.
  • CHECKPOINT.md must always reference checklist IDs.
  1. Testing discipline:
  • At the end of every major checklist section, run full regression tests.
  • Tests should be strict and hard to pass.
  • Include edge cases and failure paths.
  • Do not skip tests without explicit blocker documentation in CHECKPOINT.md.
  1. Code quality standard:
  • Write code as if every line will be audited by a hostile reviewer.
  • Optimize for correctness, safety, clarity, and maintainability.
  • Justify design choices through clean structure and strong tests.
  • Re-evaluate edits before finalizing to catch sub-optimal logic.
  1. Preferred implementation style:
  • Keep modules focused and composable.
  • Avoid hidden coupling and side effects.
  • Preserve deterministic behavior and explicit error handling.
  1. Local filesystem source of truth:
  • The single source of truth for this project is your local carsinos checkout.
  • Do not create or use git worktrees for normal implementation flow.
  • Start new work by branching from your local carsinos checkout, not by creating another filesystem copy.
  • Keep Cargo builds using the shared target directory defined in .cargo/config.toml so Rust artifacts do not multiply across local environments.