/gaia-project-context

user-facing
Category:
Documentation & Editorial
Lifecycle phase:
Any

What it does

/gaia-project-context generates a compact, AI-optimized project context document by aggregating planning artifacts and source-tree metadata into a single project-context.md. The output is designed for AI agent consumption -- terse, structured, and machine-scannable.

When to use it

  • You want AI agents to quickly understand your project's stack, conventions, and rules.
  • You need a compact context file for AI-assisted development.

Prerequisites

  • No prerequisites. Richer output when planning artifacts exist.

How to invoke

/gaia-project-context

What it does step by step

  1. Scan project Reads manifest files, README, and config files to extract high-signal metadata.
  2. Distill context Aggregates scan results with planning artifacts. Extracts project name, tech stack, naming conventions, file layout, and coding standards.
  3. Generate AI rules Produces do/don't rules, file pattern rules, and convention rules derived from evidence in the scan.
  4. Generate output Writes to .gaia/artifacts/planning-artifacts/project-context.md.

Inputs

InputSourceDescription

Outputs

OutputLocationDescription
Project context.gaia/artifacts/planning-artifacts/project-context.mdAI-optimized context document (target: under 10K tokens).

Example session

> /gaia-project-context

Scanning project metadata...
Distilling context...
Generating AI rules...

Written to .gaia/artifacts/planning-artifacts/project-context.md

What to run next

  • Use this file as context when working with AI development tools.

Troubleshooting

Large monorepo truncation

Projects with over 10K files trigger summarization. A truncation marker is embedded in the output.