Skip to content

j-mauro-r/SAT-Dengue-V2 / .agents/skills/deepworkplan

deepworkplan

Verified

DeepWorkPlan — turn any repo AI-first and run Deep Work Plans. Routes to create, execute, refine, resume, status, verify, upgrade, and repo-onboarding sub-skills based on intent. Use when the developer wants to plan, execute, manage, or verify structured multi-task work, or make a repository AI-agent-ready.

FileKindSize
SKILL.mdskill md12.0 KB
TRUST.mdmarkdown16.1 KB
addons/README.mdmarkdown11.7 KB
addons/machine-installs.mdmarkdown2.9 KB
examples/CREATE_PLAN.mdmarkdown6.9 KB
examples/ORCHESTRATOR_TASK_TEMPLATE_create_child_dwp.mdmarkdown15.0 KB
examples/ORCHESTRATOR_TASK_TEMPLATE_execute_child_dwp.mdmarkdown16.7 KB
examples/ORCHESTRATOR_TASK_TEMPLATE_integration_checkpoint.mdmarkdown9.0 KB
examples/PROMPTS_TEMPLATE.mdmarkdown4.0 KB
examples/TEAM_AGENTS_TASK_TEMPLATE.mdmarkdown5.1 KB
examples/V6_PLAN_EXAMPLE.mdmarkdown5.5 KB
guide/GUIDE.mdmarkdown8.0 KB
guide/authoring.mdmarkdown28.5 KB
guide/execution.mdmarkdown21.0 KB
guide/large-repo-onboarding.mdmarkdown3.3 KB
guide/orchestration-at-scale.mdmarkdown11.4 KB
guide/orchestrator.mdmarkdown37.9 KB
guide/prompts.mdmarkdown10.1 KB
guide/skills-integration.mdmarkdown6.5 KB
guide/structure.mdmarkdown6.2 KB
guide/swarm.mdmarkdown21.2 KB
guide/team-agents.mdmarkdown12.3 KB
shared/adaptation.mdmarkdown2.7 KB
shared/addon_sync.pyscript17.7 KB
shared/benchmark.pyscript97.6 KB
shared/config.pyscript41.5 KB
shared/context.shscript4.2 KB
shared/context_manifest.pyscript40.8 KB
shared/contract_v6.pyscript82.7 KB
shared/delegators.pyscript3.0 KB
shared/dwp-paths.mdmarkdown5.8 KB
shared/finalize_plan.pyscript7.2 KB
shared/install-verification.mdmarkdown1.8 KB
shared/ledger.pyscript141.5 KB
shared/migrate_v6.pyscript46.5 KB
shared/outcomes.pyscript27.2 KB
shared/plan_paths.pyscript4.8 KB
shared/resources.pyscript49.0 KB
shared/scheduler.pyscript41.6 KB
shared/state_contract.pyscript9.8 KB
shared/swarm.pyscript27.3 KB
shared/troubleshooting.mdmarkdown7.4 KB
shared/update-state.pyscript12.5 KB
shared/views.pyscript21.0 KB
shared/working-principles.mdmarkdown7.1 KB
spec/ADDONS.mdmarkdown27.4 KB
spec/AGENT_PROTOCOL.mdmarkdown28.0 KB
spec/ARCHETYPES.mdmarkdown10.6 KB
spec/BENCHMARK.mdmarkdown20.3 KB
spec/CONFIG.mdmarkdown8.7 KB
spec/DOCUMENTATION_STANDARD.mdmarkdown40.7 KB
spec/DWP_SPECIFICATION.mdmarkdown65.1 KB
spec/LITE_PLANS.mdmarkdown4.0 KB
spec/PLAN_STATE.mdmarkdown34.9 KB
spec/README.mdmarkdown11.5 KB
spec/V6_CONTEXT.mdmarkdown6.4 KB
spec/V6_CONTRACT.mdmarkdown12.3 KB
spec/V6_LIFECYCLE.mdmarkdown13.5 KB
spec/V6_RESOURCES.mdmarkdown4.7 KB
spec/V7_ABILITIES.mdmarkdown4.9 KB
spec/V7_CONTRACT.mdmarkdown6.4 KB
spec/V7_ROADMAP.mdmarkdown4.6 KB
spec/schema/addon-descriptor-v1.schema.jsonconfig5.5 KB
spec/schema/benchmark-record.schema.jsonconfig14.0 KB
spec/schema/context-manifest-v6.schema.jsonconfig12.5 KB
spec/schema/dwp-config-v1.schema.jsonconfig3.5 KB
spec/schema/dwp-handoff-v1.schema.jsonconfig3.0 KB
spec/schema/journal-event-v6.schema.jsonconfig22.3 KB
spec/schema/journal-event-v7.schema.jsonconfig24.9 KB
spec/schema/learnings-record.schema.jsonconfig6.0 KB
spec/schema/plan-contract-v6.schema.jsonconfig16.4 KB
spec/schema/plan-contract-v7.schema.jsonconfig16.6 KB
spec/schema/plan-manifest-v2.schema.jsonconfig1.0 KB
spec/schema/plan-manifest-v5.schema.jsonconfig1.3 KB
spec/schema/plan-manifest-v6.schema.jsonconfig2.0 KB
spec/schema/plan-manifest-v7.schema.jsonconfig1.7 KB
spec/schema/plan-manifest.schema.jsonconfig1.8 KB
spec/schema/plan-snapshot-v6.schema.jsonconfig7.8 KB
spec/schema/plan-state-v2.schema.jsonconfig6.4 KB
spec/schema/plan-state-v5.schema.jsonconfig6.7 KB
spec/schema/plan-state.schema.jsonconfig3.7 KB

spec/README.md

View on GitHub
# DeepWorkPlan Methodology Specification — v7

> The canonical normative standard for an **AI-first autopilot repository** and the
> The current **Deep Work Plan (DWP)** standard is **7.0.0** (decided for the
> 7.0.0-beta.1 release: it adds normative surface — the configuration file and
> addon registry `CONFIG.md`, addon descriptors `ADDONS.md` §7,
> addon-provided abilities `V7_ABILITIES.md`, the v7 contract generation
> `V7_CONTRACT.md` and four schemas; 6.0.0 declarations stay valid). The v5
> base documents below remain versioned 5.0.0 so existing plans keep their
> recorded rules; the four `V6_*.md` documents define the lifecycle on top of
> that base and the `V7_*.md` documents extend it. New plans created by the 7.x pack use the v7 contract generation of
> the same record layer (`V7_CONTRACT.md`: v6 plus the `parallel_safe` marker
> and delegation records); v6 plans keep v6. Existing v1/v2/v5 plans
> retain their recorded generation and are never silently migrated. Schema
> URLs are published at `https://deepworkplan.com/schema/`.

All documents use RFC-2119 normative language (MUST / SHOULD / MAY / MUST NOT) and
are grounded in an audit of 6 Dailybot repositories, in which most of the
AI-first structure was common and a small remainder was reason-per-repo (a
finding about those six repositories, not a measured constant). All three archetypes — individual repo (the default case),
orchestrator hub, and agent workspace — are addressed throughout.

## Documents

| Document | Defines |
|----------|---------|
| [`DOCUMENTATION_STANDARD.md`](DOCUMENTATION_STANDARD.md) | Repo structure: `AGENTS.md` (index + mandatory rules + quick commands), `CLAUDE.md → AGENTS.md`, the 10 `docs/` categories, per-module nested docs, `.agents/` layout, `.claude → .agents` and `.cursor → .agents` symlinks, and the reason-per-repo 10%. |
| [`DWP_SPECIFICATION.md`](DWP_SPECIFICATION.md) | The DWP workflow: the Lite-first create flow (guided review / direct trust), `.dwp/` output, the 10-section task anatomy (Touched Surface + optional Delta section), gate selection by affected surface and final-state validation, the DWP Resume Protocol, proportional rigor tiers, the single mandatory Final Review with task-local skills decisions and an optional Executive Report, compatibility rules, orchestrator + team-agents support. |
| [`AGENT_PROTOCOL.md`](AGENT_PROTOCOL.md) | Cross-agent behavior: the supported agents (interactive + autonomous platforms), the `/` vs `#` command mapping, shared `.agents/` reading, progress reporting, and the interactive vs **unattended** execution profiles. |
| [`ARCHETYPES.md`](ARCHETYPES.md) | The three archetypes (individual repo, orchestrator hub, agent workspace), the classification heuristic, and how onboarding differs. |
| [`PLAN_STATE.md`](PLAN_STATE.md) | The machine-readable plan state layer: `manifest.json` + `state.json`, gate records, outcome records, checkpoint/blocked state, reconciliation rules, and the published [JSON Schemas](schema/). |
| [`LITE_PLANS.md`](LITE_PLANS.md) | Lite and Full representations, creation grammar, promotion and v2 schema contracts. |
| [`V6_CONTRACT.md`](V6_CONTRACT.md) | **v6 line** normative surfaces: the outcome/authority `contract.json` (content-addressed identity, revisions, closed adaptation enumeration) and the append-only `journal.ndjson` event catalog with trust labels; published as `schema/plan-contract-v6` + `schema/journal-event-v6`. Binds v6 new plans only — the v5 standard is untouched. |
| [`V6_CONTEXT.md`](V6_CONTEXT.md) | **v6 line** context contract: the per-task context manifest (derived, never stored — Q6 derivation table), mandatory sections no pruning may drop, the next-action ladder, the retention-biased dead-end digest (U4), input-fingerprint freshness invalidation, history loading by trigger only, and the four-quantity accounting rule (bytes / tokens / cost / wall-clock — missing stays missing, never bytes-to-money). Binds v6 new plans only. |
| [`V6_RESOURCES.md`](V6_RESOURCES.md) | **v6 line** resource contract: host capability negotiation (closed ability set, minimal-host floor), the counter-source split (journal vs host meter, unknown unit = advisory), limit reserves with a runtime dispatch ceiling, the `LIMIT:` exhaustion grammar with derived dispatch holds, exactly-once cancellation settlement (`RESERVATION:` grammar, double-charge refused), and fixed-model-default routing posture (grant AND host ability). Binds v6 new plans only. |
| [`V6_LIFECYCLE.md`](V6_LIFECYCLE.md) | **Current v6** flow wiring: plan-generation detection by artifacts (manifest contract pointer / `contract.json` / `contracts/` chain — never by skill version alone), the v6 activation rule (default for pack line 6+), the guarded materialization order (manifest → contract → approval, resumable, refusals that hold), the execution boundary (scheduler dispatch, runner-only observed evidence, derived completion), the amendment path (revision chain + fresh approval + evidence invalidation), read-only status/verify surfaces, v5/v6 coexistence, the explicit one-directional v5 migration (preview → backup → contract → manifest swap → journal import → projection, rollback guarded by real history), cross-agent/cold resume (journal-is-truth ladder, export handoff), and the v6 onboarding guidance (capability declaration, authority boundaries, outcome/test mapping, concise context). Binds v6 new plans only. |
| [`BENCHMARK.md`](BENCHMARK.md) | **v6 line, opt-in** field-metrics subsystem: the `.dwp/config.json` / `~/.dwp/config.json` discovery and precedence (fail-closed to disabled), the completion-time emission point and its atomic/deterministic/idempotent artifacts, the five metric-provenance classes (journal/identity/environment/metered-only/context-manifest), the closed record field set (published as `schema/benchmark-record`, with optional per-task spans and context accounting from the pre-release v1 amendment), the counts-vector complexity profile with composites deferred, the aggregation contract with its non-causality note plus the learnings digest, the privacy boundary, the version-over-version use limits, and the learnings section (§10 — nested `learnings` flag, two halves derived/curated, closed category vocabulary, anchor grammar, written-once; published as `schema/learnings-record`, rendered into the unified `DWP_REPORT.md`). Never a conformance gate; disabled repositories behave byte-identically. |
| [`CONFIG.md`](CONFIG.md) | **7.0.0** configuration file: `.dwp/config.json` / `~/.dwp/config.json` — one shape, one stdlib parser (`shared/config.py`), two keys: `benchmark` (wholesale, `BENCHMARK.md` §1) and the `addons` registry (per-key precedence, keys = in-pack addon directory names, closed `{enabled, version}` entries, fail-closed with one warning, unknown keys ignored, absent = not enabled, informative `version`); the reconciling consent-gated writer used by `onboard`; published as `schema/dwp-config-v1`. The registry can only offer or amplify — never gate conformance or a plan. |
| [`V7_CONTRACT.md`](V7_CONTRACT.md) | **7.0.0** contract generation v7 of the v6 record layer: `plan-contract/v7` = v6 + optional `tasks[].parallel_safe` (the create-time delegation marker); `journal-event/v7` = v6 + the `delegation` event (launched/completed/failed/cancelled; never evidence — a delegate's result stays `asserted` until this plan's runner observes it); `plan-manifest/v7`; generation by schema URL, never mixed; the record-layer delegation gate and `ledger.py delegate launch|observe|collect|cancel`. v6 schema bytes unchanged. |
| [`V7_ABILITIES.md`](V7_ABILITIES.md) | **7.0.0** addon-provided abilities: effective abilities = host-declared ∪ `provides_abilities` of addons that are enabled in the registry, carry a valid `addon.json`, are detected (argv detect with no shell and a timeout, or paths) and report a compatible interface major; one warning and no contribution otherwise; never persisted into a plan; an ability is never authority (grants still apply) and never consent (telemetry). Extends `V6_RESOURCES.md` §1 without changing it. |
| [`V7_ROADMAP.md`](V7_ROADMAP.md) | **Non-normative** planning record for v7: the optional addons (Herdr, DeepWorkPlan Vim), a pointer to the peer protocol that now lives in herdr-peers, and the never-a-conformance-gate posture. Nothing here gates the current standard. |
| [`ADDONS.md`](ADDONS.md) | The addon mechanism + contract (reconcile-don't-clobber); seven opt-in addons plus the AI Diff Reviewer local review, required in the baseline since 2.3.0 (§6.5). |

## Key v2 Divergences from v1 (see `../RECONCILIATION.md`)

1. Distribution: WebFetch framework repo → **installed skill pack** (idea #2).
2. Output path: `.agent_commands/.../results/` → gitignored **`.dwp/`** (idea #3).
3. Create flow: two-step draft → **single refined draft** (idea #4).
   *(Superseded in 2.4.0: the draft is gone entirely — `create` materializes an
   executable Lite plan, see [`LITE_PLANS.md`](LITE_PLANS.md).)*
4. **`.claude → .agents`** and **`.cursor → .agents`** directory symlinks + canonical `.agents/` (idea #1).
5. **Two archetypes** made first-class (idea #5).
6. **Per-module `README.md` + `docs/`** formalized as normative (idea #6).
7. **Opt-in addons** mechanism, devcontainer first (idea #7).
8. Version **1.0.0 → 2.0.0** (major, breaking).

## Minor revisions in 2.2.0 (additive, no breaking changes)

- **Machine-readable plan state layer** (`PLAN_STATE.md`, net-new):
  `manifest.json` + `state.json` as a derived projection of the plan markdown,
  with published JSON Schemas (`schema/`), per-task validation-gate records
  (`passes` flags), outcome records (episodic memory), checkpoint and blocked
  state, and markdown-wins reconciliation. RECOMMENDED for new plans; REQUIRED
  for unattended execution and for workspaces without git.
- **Proportional rigor tiers** (`DWP_SPECIFICATION.md` §11): micro / standard /
  deep. A plan folder MUST NOT be created for a trivial single-file change; the
  tier changes the packaging, never the gates.
- **Delta section** (`DWP_SPECIFICATION.md` §5.0.1): optional
  ADDED / MODIFIED / REMOVED behavior contract for brownfield tasks.
- **The DWP Resume Protocol** (`DWP_SPECIFICATION.md` §5.3): the resume ritual
  promoted to a named, citable six-step protocol (re-anchor → checkpoint →
  reconcile → inspect the seam → smoke-test → continue atomically).
- **Agent workspace archetype** (`ARCHETYPES.md` §4): the long-lived home of an
  autonomous agent (OpenClaw, Hermes, cloud agents) as a third archetype; git
  RECOMMENDED rather than assumed, with `state.json` carrying recovery state.
- **Execution profiles** (`AGENT_PROTOCOL.md` §7): interactive vs unattended —
  pre-approved plans, bounded authority, stop conditions, scheduled
  continuation. OpenClaw and Hermes join the supported-agents table.
- **Automated conformance** (`verify/conformance.sh`): the verify sub-skill
  gains a mechanical, CI-friendly checker (exit 0/1) covering repo structure,
  plan well-formedness, and state-layer desync.

## Minor revisions in 2.1.0

- **Test & validation discipline made first-class** (minor, additive): tasks that
  add or change product behavior MUST carry automated test coverage in their
  acceptance criteria and run the repo's tests + lint/type-check in their
  validation gate (`DWP_SPECIFICATION.md` §5.1.1); onboarding MUST define a real
  or proposed test/lint toolchain so every future plan has an objective gate
  (`DOCUMENTATION_STANDARD.md` §3.3).

---

*DeepWorkPlan methodology v6, MIT License, by [Dailybot](https://dailybot.com) / dailybotops.*
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall