work/¶

This directory is the working area for in-progress and historical execution plans across Devonshire Digital and its ventures. It is separate from permanent documentation (docs/) and from decision records (docs/decisions/) — work/ is about doing, not about deciding or documenting policy.

Structure¶

work/templates/ — reusable starting points for work artifacts, including templates/task-plan.md (the standard shape for a task/execution plan) and templates/handoff.md (the standard shape for handing work from one agent/session to another). These templates are owned and maintained independently — do not fork their structure without good reason.
work/active/ — plans currently being executed. See active/README.md.
work/archive/ — completed plans retained for historical or decision-record value. See archive/README.md.

Expectations for agents and contributors¶

Start a nontrivial task by copying work/templates/task-plan.md into work/active/ with a descriptive, date-prefixed filename.
Keep the plan updated as work progresses — it should reflect current reality, not the original guess.
When work concludes, do not leave the plan sitting in work/active/. Either:
move it to work/archive/ if it has lasting historical value (non-trivial decisions made, context future agents will want), or
delete it if it was purely mechanical and has no lasting value.
Never commit secrets, credentials, or sensitive customer data into any file under work/. These files are plain markdown and are not treated as secure storage.
If a plan surfaces a decision that should bind future work, capture that decision as an ADR under docs/decisions/ — work/ plans are not a substitute for the decision record.

Report an issue about this page