Exercise 01: Setup Project

Objective

Copy the Practitioner tier into the sandbox project as .cursor/ and verify the full directory structure. Confirms the base project works before starting multi-agent exercises.

Required Reading

• Practitioner README
• Customizing Agents | Cursor Learn -- How custom agent definitions are structured
• Custom Agents | Cursor Docs -- Agent .md files, AGENTS.md registry, and subagent_type mapping
• Rules | Cursor Docs -- How .mdc rule files in .cursor/rules/ provide persistent instructions to agents
• Agent Skills | Cursor Docs -- How SKILL.md files in .cursor/skills/ give agents reusable capabilities

CursorClaude Code

The exercises and validation below work in Cursor. Use the Cursor documentation links in Required Reading.

In Claude Code, the equivalent project structure uses CLAUDE.md (instead of .cursor/rules/), .claude/skills/ (identical SKILL.md format), and agent definitions through prompts rather than .md frontmatter files. The directory structure you set up here establishes the foundation for either system.

Tasks

1. Copy the Practitioner tier config into sandbox/.cursor/. Copy only the operational directories -- do not copy tutorials/ or walkthrough/:

   mkdir -p sandbox/.cursor
   cp -r .cursor-practitioner/agents sandbox/.cursor/
   cp -r .cursor-practitioner/rules sandbox/.cursor/
   cp -r .cursor-practitioner/skills sandbox/.cursor/
   cp -r .cursor-practitioner/pipeline sandbox/.cursor/
   cp -r .cursor-practitioner/templates sandbox/.cursor/
   cp .cursor-practitioner/AGENTS.md sandbox/.cursor/
   cp .cursor-practitioner/README.md sandbox/.cursor/
   

2. Verify directory structure:

3. sandbox/.cursor/agents/ has agent .md files (at least 4: planner, subplanner, worker, tester, etc.)
4. sandbox/.cursor/rules/ has .mdc rule files (at least 1)
5. sandbox/.cursor/skills/ has skill directories

6. sandbox/.cursor/pipeline/ has schema.py and check.py

7. Run commands in the sandbox:

   cd sandbox && npm install
   npm test        # 1 test passes (GET / returns 200)
   npm run typecheck  # no errors
   

Validation

python3 docs/practitioner/tutorials/verify.py --exercise 01

Checks: agent files exist, rule files exist, pipeline scripts exist, node_modules exists, npm test passes.

Reflection

• How many agents are in the Practitioner tier? What are their roles?
• What files does pipeline/ contain and what do they do?
• Why do we copy the tier into the project rather than referencing it directly?

Answer

After setup, sandbox/.cursor/ should contain:

• agents/ with 7+ agent .md files (planner, subplanner, worker, tester, reviewer, debugger, git, benchmarker)
• rules/ with 4 .mdc files (planner-first, commit-conventions, issue-workflow, pr-review)
• skills/ with 2 skill directories (jg-pipeline-artifact-io, jg-benchmark-ops)
• pipeline/ with schema.py, check.py, README.md
• templates/ with agent.md, rule.mdc, state.yaml.example
• AGENTS.md and README.md

Verification: cd sandbox && npm test should show 1 passing test.