Completo Briefing Generator

Generate a Completo-Briefing.md file that gives the remote Completo server enough context about the project to write high-quality AI-powered ticket descriptions. The remote AI cannot see the source code — this file is its only window into the project.

Why This Exists

Completo's AI features (card description generation, improvement) use a "project briefing" as context. Developers typically have a CLAUDE.md or AGENTS.md that describes the project for local agents — but those files are optimized for agents that can read the code. They say things like "architecture decisions only, nothing obvious from reading the source." The remote Completo AI has no source code access, so it needs a different, more self-contained document.

The briefing serves a specific purpose: helping the AI write ticket headlines and descriptions — scoped work items with acceptance criteria. This means the AI needs to understand not just what the product is, but how work gets done in this project: what workflow stages exist, what a good ticket looks like, what level of detail is expected, and what conventions govern the codebase at a level that affects ticket scoping.

When to Run This

• When setting up Completo for a new project
• When the project's architecture, domain model, or conventions change significantly
• When AI-generated card descriptions are missing context or using wrong terminology
• When the user explicitly asks to update the briefing

Workflow