ownership-partitioning

Ownership Partitioning

This skill is loaded into every writer agent (unity-dev, data-tool) whenever pipeline.json.parallel_allowed == true. It is enforced at runtime by orchestrate.py ownership-check.

Source of Truth

workspace/ownership.lock.json. Format:

{
  "partitions": {
    "unity-dev": ["Assets/Scripts/Combat/**", "Assets/Scripts/Movement/**"],
    "data-tool": ["Assets/Editor/Combat/**", "Assets/Configs/Combat/**"]
  },
  "shared_read_only": ["ProjectSettings/**", "Packages/**"],
  "forbidden": ["Assets/Plugins/**"],
  "rationale": "Combat refactor — runtime vs tooling are disjoint"
}

Globs are repo-root-relative, POSIX-style (use /, not \). ** matches any number of path segments.

Rules

1. You may only write to files matching one of YOUR partition globs. Writing to another agent's partition is a hard violation.

2. shared_read_only files may be read by anyone but NEVER written this session. If you genuinely need to change one, escalate.

3. forbidden files must not be touched at all (typically generated code, third-party plugins, lockfiles).

4. Before signaling the next phase, run the check explicitly:

   python .claude/scripts/orchestrate.py ownership-check <your-agent-name> \
       Assets/Scripts/Combat/Health.cs Assets/Scripts/Combat/Damage.cs
   

   Non-zero exit means you have a violation. Roll back that file and re-run.

Architect Responsibilities

For large / critical complexity, the architect writes workspace/ownership.lock.json as part of the approved_plan.json phase. The partition must:

• Have non-overlapping globs across agents
• Cover every file the plan expects to change
• Not include shared_read_only paths inside any partition

The orchestrate.py gate refuses to enter the implementation phase if ownership.lock.json is missing for any plan with parallel_allowed=true.

Triage Responsibilities

For tiny / small / medium complexity with a single writer, triage may either (a) omit ownership.lock.json entirely (unrestricted single writer), or (b) write a single-agent partition to lock the writer to a known glob.