Note

    AGENTS

    Agent Instructions These instructions apply to all AI assistants working in this repository. Core Rules - Always review CHANGELOG. Imported Co...

    Agent Instructions These instructions apply to all AI assistants working in this repository. ## Core Rules - Always review `CHANGELOG.

    Agent Instructions

    These instructions apply to all AI assistants working in this repository.

    Core Rules

    • Always review CHANGELOG.md and ROADMAP.md before starting significant work.
    • Treat the docs root (DOCS/ or docs/) as the documentation source of truth.
    • Update docs when code changes affect behavior, workflows, or interfaces.
    • Maintain frontmatter (title, description, status, lastUpdated, owner).
    • Keep docs/README.md and docs/index.md accurate.
    • Use checkpoint-based progress updates instead of today/tomorrow handoff wording.
    • Generate timestamps with node scripts/docs/timestamp-et.mjs --json (never hand-type them).
    • Each project update must include:
      • absolute timestamp (YYYY-MM-DD HH:MM ET (America/New_York))
      • completed since prior checkpoint
      • next checkpoint targets

    Project Planning

    • Create a numbered project doc under docs/projects/active/ at project kickoff.
    • Keep the reusable project template at docs/projects/NNNN_project_template.md.
    • Move the doc across status folders as work progresses.
    • Reference the project number in roadmap and changelog entries.
    • Maintain a checkpoint log in each project doc and add a checkpoint for major decisions, delivery milestones, or scope changes.

    Docs Site

    • Local dev: npm --prefix docs-site run dev
    • Build: npm --prefix docs-site run build
    • Cloudflare Pages: Root Directory repo root, Build command npm --prefix docs-site run build, Build output directory docs/.vitepress/dist

    Documentation

    • Canonical docs index: docs/README.md
    • Docs home: docs/index.md
    • Project tracking: docs/projects/index.md

    Provenance