project_agentic-workspace-template

Agent-optimised project repository for the {{CLIENT_NAME}} client project at {{AGENCY_NAME}}.

Quick start

Starting a session (Cursor / VS Code / terminal)

Say or type: start session The agent will pull latest, show what changed, and brief you from CONTEXT.md.

Starting a session (Claude.ai web)

Paste the contents of .agent/CONTEXT.md as your first message.

Logging a quick task (Mode A)

Say: log this or log mode a

Ending a session

Say: end session or wrap up The agent will write a session note and stage your commits.

First-time setup checklist

• [ ] Fill in all {{PLACEHOLDERS}} in .agent/project.md
• [ ] Write project-specific rules in .agent/instructions.md
• [ ] Fill in docs/specs/sow-shared.md from the shared SoW
• [ ] Add website repo as submodule: git submodule add [url] website/
• [ ] Run python scripts/generate-context.py locally to verify
• [ ] Push and confirm context-update.yml runs cleanly
• [ ] Set up n8n daily-digest and sprint-sync workflows
• [ ] Register Slack /session slash command

Key docs

• Implementation Spec — full specification: workflow, folder structure, file templates, automation scripts, and implementation checklist
• Mermaid Diagrams — visual diagrams of the workflow, digest pipeline, sync rules, and folder ownership
• Shared SoW — project scope, deliverables, milestones (no financials)
• First decision — why this repo structure was adopted
• JIRA: