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.
• 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

• Docs root: docs/
• VitePress home: docs/index.md
• Docs wrapper: docs-site/
• Docs regeneration workflow: .github/workflows/docs-site-sync.yml
• Docs deploy workflow: .github/workflows/docs-pages.yml

Provenance

• Source file: AGENTS.md
• Source URL: https://github.com/maggielerman/app-growth-agent/blob/main/AGENTS.md