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/schema/benchmark-record.schema.json

View on GitHub
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://deepworkplan.com/schema/benchmark-record/v1.json",
  "description": "Deep Work Plan benchmark record, v1 (spec/BENCHMARK.md). One closed JSON object per completed v6 plan, emitted into the plan's analysis_results/ by shared/benchmark.py when the repository opted into benchmark mode (.dwp/config.json or ~/.dwp/config.json). The record is derived, never imputed: every field comes from records the plan already owns (journal.ndjson events, manifest.json, contract.json, state.json, best-effort git diff stats). Quantities with no recording source are null - most notably tokens and spend, which exist only when resource_sample events were journaled by a metering host. The record carries no emission timestamp: two runs over identical plan bytes produce identical bytes (spec section 8). v5-generation plans are never measured. The subsystem is opt-in and never a conformance gate. The optional timing.task_spans and context_accounting fields are a pre-release v1 amendment (ADR-0005 in the skill repository): no released pack minted this $id before they landed, optional-only so every earlier committed record still validates.",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "schema",
    "plan",
    "title",
    "generation",
    "contract_id",
    "status",
    "versions",
    "timing",
    "shape",
    "friction",
    "gates",
    "metered",
    "environment",
    "diff_stats"
  ],
  "properties": {
    "schema": {
      "const": "https://deepworkplan.com/schema/benchmark-record/v1.json"
    },
    "plan": {
      "type": "string",
      "pattern": "^PLAN_([0-9]{3,}_)?[a-z0-9]+(_[a-z0-9]+){1,4}$",
      "description": "Plan folder name, same grammar as the journal's plan field."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Human plan title from the manifest."
    },
    "generation": {
      "enum": ["v6", "v7"],
      "description": "Only v6- and v7-generation plans are measured; the v5 line is frozen."
    },
    "contract_id": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$",
      "description": "The plan's materialized outcome contract id."
    },
    "status": {
      "enum": [
        "ready",
        "in_progress",
        "blocked",
        "completed"
      ],
      "description": "Plan status projected from state.json at derivation time."
    },
    "versions": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "dwp_skill",
        "spec",
        "agent_tool"
      ],
      "properties": {
        "dwp_skill": {
          "type": "string",
          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
          "description": "Version of the emitting pack (its SKILL.md frontmatter version)."
        },
        "spec": {
          "type": "string",
          "description": "DWP standard the plan recorded (for example 6.0.0)."
        },
        "agent_tool": {
          "type": "string",
          "description": "Detected agent tool name, mirroring context.sh's families and labels (claude-code, codex-cli, cursor, openclaw, gemini-cli, windsurf), or 'unknown'."
        }
      }
    },
    "timing": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "first_event_ts",
        "last_event_ts",
        "span_seconds",
        "task_count_spanned"
      ],
      "properties": {
        "first_event_ts": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp of the first journal event (the approval)."
        },
        "last_event_ts": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp of the last journal event at derivation time."
        },
        "span_seconds": {
          "type": "integer",
          "minimum": 0,
          "description": "Calendar span between first and last event. NOT compute time: sessions idle, hosts restart, humans review (spec section 3)."
        },
        "task_count_spanned": {
          "type": "integer",
          "minimum": 0,
          "description": "Number of distinct tasks with at least one task_start event - interrupted and retried tasks count once."
        },
        "task_spans": {
          "type": "array",
          "description": "Per-task calendar spans, one entry per distinct task_start event (an interrupted-and-restarted task carries one entry per start). Optional field: a pre-release v1 amendment; absent when the journal records no task_start events. Calendar span, not compute time (spec section 3).",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "task",
              "start_ts",
              "end_ts",
              "span_seconds"
            ],
            "properties": {
              "task": {
                "type": "string",
                "pattern": "^T-[a-z0-9]+(-[a-z0-9]+)*$",
                "description": "Task id from the contract."
              },
              "start_ts": {
                "type": "string",
                "format": "date-time",
                "description": "Timestamp of the task's task_start event."
              },
              "end_ts": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Timestamp of the task's completion evidence; null when the window holds no completion evidence for that start - never zero, never imputed."
              },
              "span_seconds": {
                "type": [
                  "integer",
                  "null"
                ],
                "minimum": 0,
                "description": "Calendar distance start_ts to end_ts; null exactly when end_ts is null."
              }
            }
          }
        }
      }
    },
    "shape": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "tasks",
        "criteria",
        "invariants",
        "gate_intents",
        "events"
      ],
      "properties": {
        "tasks": {
          "type": "integer",
          "minimum": 1,
          "description": "Task count from the contract."
        },
        "criteria": {
          "type": "integer",
          "minimum": 1,
          "description": "Acceptance criteria declared in the contract."
        },
        "invariants": {
          "type": "integer",
          "minimum": 0,
          "description": "Invariants declared in the contract."
        },
        "gate_intents": {
          "type": "integer",
          "minimum": 0,
          "description": "Sum of declared gate-intent criteria across tasks."
        },
        "events": {
          "type": "integer",
          "minimum": 1,
          "description": "Total journal events at derivation time."
        }
      }
    },
    "friction": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "adaptations",
        "amendments",
        "interventions",
        "refusals",
        "retries"
      ],
      "properties": {
        "adaptations": {
          "type": "integer",
          "minimum": 0,
          "description": "Count of adaptation events."
        },
        "amendments": {
          "type": "integer",
          "minimum": 0,
          "description": "Count of amendment events (contract revisions)."
        },
        "interventions": {
          "type": "integer",
          "minimum": 0,
          "description": "Count of intervention events (human or host break-ins)."
        },
        "refusals": {
          "type": "integer",
          "minimum": 0,
          "description": "Count of refusal events (every refusal is itself recorded)."
        },
        "retries": {
          "type": "integer",
          "minimum": 0,
          "description": "Count of gate_run events sharing a criterion with an earlier failing gate_run for the same task."
        }
      }
    },
    "gates": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "runs",
        "exit_0",
        "exit_nonzero",
        "evidence_histogram"
      ],
      "properties": {
        "runs": {
          "type": "integer",
          "minimum": 1,
          "description": "Total gate_run events."
        },
        "exit_0": {
          "type": "integer",
          "minimum": 0,
          "description": "Gate runs that exited 0."
        },
        "exit_nonzero": {
          "type": "integer",
          "minimum": 0,
          "description": "Gate runs that exited nonzero, including 124 timeouts."
        },
        "evidence_histogram": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "observed",
            "imported",
            "asserted"
          ],
          "properties": {
            "observed": {
              "type": "integer",
              "minimum": 0,
              "description": "Evidence minted by a shipped executor itself (A1)."
            },
            "imported": {
              "type": "integer",
              "minimum": 0,
              "description": "Evidence carried in from outside the journal's own execution."
            },
            "asserted": {
              "type": "integer",
              "minimum": 0,
              "description": "Claims by a mediating actor - never behavior."
            }
          }
        }
      }
    },
    "metered": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "flag",
        "tokens",
        "spend_usd"
      ],
      "properties": {
        "flag": {
          "type": "boolean",
          "description": "False unless a token or spend resource_sample was observed; samples for other limit ids are advisory and never set the flag. Never synthesized."
        },
        "tokens": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "Latest observed token resource_sample (highest seq, selection unit \"tokens\" - AGENT_PROTOCOL 8.4, never a sum of samples); null when not metered (spec section 3 - missing stays missing)."
        },
        "spend_usd": {
          "type": [
            "number",
            "null"
          ],
          "minimum": 0,
          "description": "Latest observed spend resource_sample (highest seq, selection limit_id \"spend_usd\", unit USD - never a sum of samples); null when not metered."
        }
      }
    },
    "environment": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "repo",
        "branch"
      ],
      "properties": {
        "repo": {
          "type": "string",
          "minLength": 1,
          "description": "Repository name (basename only - the privacy boundary forbids absolute user paths, spec section 7)."
        },
        "branch": {
          "type": "string",
          "minLength": 1,
          "description": "Branch name of the plan's repository at derivation time; 'unknown' outside git."
        }
      }
    },
    "diff_stats": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "available",
        "files",
        "insertions",
        "deletions"
      ],
      "properties": {
        "available": {
          "type": "boolean",
          "description": "False whenever the git window could not be computed; the three counts are then null, never zero (spec section 3)."
        },
        "files": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "Files changed in the plan window."
        },
        "insertions": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "Insertions in the plan window."
        },
        "deletions": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "Deletions in the plan window."
        }
      }
    },
    "context_accounting": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "available",
        "instruction_bytes",
        "provider_tokens",
        "cost_usd",
        "wall_clock_hours"
      ],
      "description": "The four-quantity context accounting block (spec section 3), each quantity from its own source, missing as missing. Optional field: a pre-release v1 amendment. Populated only when the plan's context accounting is recoverable at emission time; otherwise available is false and all four values are null - never synthesized.",
      "properties": {
        "available": {
          "type": "boolean",
          "description": "False when the plan's context accounting could not be recovered at emission time; the four values are then null, never zero."
        },
        "instruction_bytes": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "Measured static instruction bytes (the context manifest plus any declared bundle files); measured, not estimated."
        },
        "provider_tokens": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0,
          "description": "Latest observed token meter sample; null without resource_sample events. The same recording as metered.tokens, carried once more so the four quantities read as one unit."
        },
        "cost_usd": {
          "type": [
            "number",
            "null"
          ],
          "minimum": 0,
          "description": "Latest observed spend sample in USD, from real rates only - never bytes-to-money; null without resource_sample events. The same recording as metered.spend_usd."
        },
        "wall_clock_hours": {
          "type": [
            "number",
            "null"
          ],
          "minimum": 0,
          "description": "Recorded event ts span in hours; the same recording as timing.span_seconds, carried once more so the four quantities read as one unit."
        }
      }
    }
  }
}
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