Skip to main content

Specification

The full .project standard specification is maintained at spec/v1/specification.md.

Version: 1.0.0-draft

The specification covers:

  • Directory structure and naming conventions
  • PROJECT.md manifest (the only required file)
  • Instructions, memory, conversations systems
  • Context vs resources — loadable files vs external references
  • Tasks (A2A-compatible) and agents
  • Extensions and marketplace support
  • Adapters for provider-specific mapping
  • Multi-user support and hierarchical override
  • Security model and gitignore conventions
  • Loading protocol — the normative 3-tier progressive disclosure algorithm
  • AGENTS.md reconciliation — pointer and fallback patterns

Read the full specification on GitHub