Skip to content

docs: Add job porting design document#196

Open
ncrmro wants to merge 2 commits intomainfrom
docs/job-porting
Open

docs: Add job porting design document#196
ncrmro wants to merge 2 commits intomainfrom
docs/job-porting

Conversation

@ncrmro
Copy link
Collaborator

@ncrmro ncrmro commented Jan 31, 2026

Summary

  • Adds doc/job-porting.md documenting the design for a /deepwork_jobs.port skill
  • Covers global (~/.deepwork/) vs project-local scope mapping, portability tensions (output paths, doc specs, instructions, hooks, AGENTS.md), precedence model, and required infrastructure changes
  • Proposes a scope: portable | local field in job.yml to make portability a design-time decision

Test plan

  • Review document for accuracy against current codebase conventions
  • Validate proposed ~/.deepwork/ directory convention aligns with team direction

🤖 Generated with Claude Code

ncrmro and others added 2 commits January 31, 2026 12:06
Documents the design for `/deepwork_jobs.port`, covering global vs
project scope mapping, portability tensions, the `scope` field proposal,
and required infrastructure changes.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Adds seven validation scenarios covering audit accuracy, round-trip
porting, precedence override, concretization, blocked ports, doc spec
collisions, and sync isolation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant