Recover Existing Intent

Use this flow when a repo already has useful intent artifacts, but they are hard to find, address, or hand to an agent.

If you already know the goal, start with the task:

ds task "implement the bounded change"

Use the trust layer when you need orientation first.

Map System Boundaries

ds map

ds map shows architecture or system boundaries DevSpecs can infer from local files, tests, docs, and git evidence. It is for onboarding and orientation, not for executing a task.

Recover Recent Direction

ds recent

ds recent shows recently active local git topics and follow-up context commands. Use it after returning to a repo or before trusting older plans.

Inspect Evidence

ds find "oauth redirect"

ds find builds packed context by default: source, tests, docs, receipts, and excluded noise. Use --plain only when you want flat ranked results.

ds find "oauth redirect" --plain

Export One Exact Artifact

ds context <artifact-id>

Use IDs from ds find, ds show, or JSON output when you want one exact plan, spec, ADR, or task artifact as paste-ready agent context.

Adopt Existing Artifacts

ds adopt is planned, not shipped. The intended default is:

ds adopt --dry-run
ds adopt --all

Adoption should create thin wrapper artifacts that make older plans, PRDs, RFCs, and ADRs addressable without mutating the original files by default.