Context Graph Skill

Manages module-level locking for parallel agent coordination.

Commands

claim

Claim modules before starting work.

code

Use context-graph skill: claim
Modules needed: [auth, database]
Feature: F003 - Add password reset

Steps:

•Read .context/modules.yaml
•Check each module's locked_by
•If all available: set locks, increment version, commit
•If any locked: STOP, report which are unavailable

Success: "Claimed modules: [auth, database]. Version: abc→def"

Failure: "Cannot claim. auth locked by session-xyz for F002."

release

Release modules when done.

code

Use context-graph skill: release

Steps:

•Read .context/modules.yaml
•Clear locked_by, locked_at, locked_for for your modules
•Increment version, commit

Response: "Released modules: [auth, database]. Version: def→ghi"

status

Check current lock state.

code

Use context-graph skill: status

Response:

code

Module Status (version: def456)

| Module   | Status | Locked By   | For                | Since     |
|----------|--------|-------------|--------------------|-----------|
| auth     | LOCKED | session-xyz | F002 - OAuth       | 5 min ago |
| payments | FREE   | -           | -                  | -         |

⚠️ No stale locks detected.

which

Find which module a file belongs to.

code

Use context-graph skill: which
File: src/handlers/auth/login.ts

Response: "File belongs to module: auth"

force-release

Force release a stale lock.

code

Use context-graph skill: force-release
Module: auth
Reason: Previous session terminated

Only use after verifying session is abandoned (>24h or confirmed dead).

modules.yaml Format

yaml

version: "abc123"
updated_at: "2025-02-01T10:25:00Z"

strategy: explicit

modules:
  auth:
    description: "Authentication"
    paths:
      - src/auth/
      - src/handlers/auth/
    locked_by: null
    locked_at: null
    locked_for: null

Rules

•Always claim before modifying module code
•Always release at session end
•Never modify unclaimed modules
•Report locked modules to orchestrator
•Check status if unsure