Contributing

Thank you for contributing to @maestria/cursor. For general setup and PR workflow, see the Contributing Guide.

Project structure

packages/cursor/
├── .cursor-plugin/plugin.json   # Manifest
├── sync.config.ts               # Transforms from core directives
├── agents/                      # Generated specialists (do not edit)
├── skills/orchestrator/         # Generated (do not edit)
├── rules/                       # Generated (do not edit)
├── commands/                    # Hand-authored workflow commands
├── tests/
├── INSTALL.md
├── README.md
└── CHANGELOG.md

Caution

Never edit generated files under agents/, skills/, or rules/ directly. Edit packages/core/agent-directives/ and run sync.

Editing methodology

1. Change canonical files in packages/core/agent-directives/

2. Adjust packages/cursor/sync.config.ts if Cursor-specific transforms are needed

3. Run sync:

   cd packages/cursor && npx tsx ../core/scripts/sync.ts --verbose
   # or from repo root
   ./scripts/sync-all

4. Verify: ./scripts/check-sync and pnpm --filter @maestria/cursor test

Editing commands

Workflow commands in commands/ are hand-authored (not synced). Keep them thin: mode marker + pipeline instructions that point at the orchestrator skill and Task agents.

ADR

Architecture decisions: ADR-CR-001.