Agentic Development Velocity Template

A practical template repository for developing faster with AI across:

• UI test automation (Robot Framework, Playwright)
• UI and backend product development
• CI/CD pipelines and operational debugging

This template is opinionated around one goal: reduce time-to-green by improving context quality and execution discipline.

Quick start

1. Fill command placeholders in docs/runbook.md and AGENTS.md.
2. Add repo architecture and conventions in docs/architecture.md and docs/conventions.md.
3. Run work with prompt templates from prompts/.
4. Use scripts/context-pack.ps1 before medium/large tasks.
5. Use scripts/validate.ps1 after every patch.
6. Track outcomes in eval/metrics-template.csv.

Standard loop

1. Intent: define task and success criteria.
2. Retrieve: gather the right files/symbols and cite file:line.
3. Patch: implement smallest correct change.
4. Verify: run lint, typecheck, unit/integration/e2e checks.
5. Remember: update docs/ai-memory.md with new durable facts.

Repository layout

• AGENTS.md: required agent operating protocol.
• docs/: architecture, standards, runbooks, memory, patterns.
• prompts/: reusable task prompts for coding and automation.
• scripts/: context gathering and validation helpers.
• eval/: lightweight evaluation set and metrics tracking.
• .github/: issue templates, PR template, and CI workflow starter.
• mcp/: MCP integration templates and notes.
• .cursor/: Cursor project config (rules, MCP wiring, integration notes).
• .cursorignore: Cursor context exclusion list.
• .cursorindexingignore: Cursor indexing exclusion list.

Cursor fit with this structure

Use this mental model so nothing is duplicated or misplaced:

1. Policy lives in AGENTS.md and docs/.
2. Cursor routes policy by scope using .cursor/rules/*.mdc.
3. Tool execution lives in scripts/.
4. MCP guidance remains in mcp/, while Cursor's active project config lives in .cursor/mcp.json.
5. Ignore behavior is split:
   • .cursorignore for context/reference exclusion
   • .cursorindexingignore for indexing exclusion only

How to turn this into a GitHub template repo

1. Initialize git and push to GitHub.
2. In GitHub repo settings, enable Template repository.
3. Keep docs current; stale context reduces AI quality quickly.

Recommended operating habit

One task per thread. When a thread gets long, checkpoint with:

• Goal
• Decisions
• Constraints
• Open risks
• Next steps

Start a fresh thread from that checkpoint.