Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .agents/commands/ai-diff-reviewer-apply-review.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
description: Read the CI review on the current PR and walk through findings (provided by the vendored `ai-diff-reviewer` skill)
---

# /ai-diff-reviewer-apply-review — provided by the `ai-diff-reviewer` skill

> Thin alias. The flow lives in the vendored `ai-diff-reviewer` skill — this
> file only routes to it, so there is a single source of truth and no drift.

## What to do

Route this invocation to the **apply-review** sub-skill of the vendored
`ai-diff-reviewer` skill and follow it: read
`.agents/skills/ai-diff-reviewer/apply-review/SKILL.md` and execute its flow
(anchor on the latest `<!-- ai-pr-reviewer-marker -->` comment, skip minimized
comments, per-finding apply / defer / skip consent; never commits or pushes).
This is the executable counterpart of `docs/PR_REVIEW_WORKFLOW.md`.

> Other agents: invoke the sub-skill directly
> (`#ai-diff-reviewer-apply-review` in Cursor/Codex/Gemini).
19 changes: 19 additions & 0 deletions .agents/commands/ai-diff-reviewer-generate-extension.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
description: Regenerate `.review/extension.md` from repo evidence (provided by the vendored `ai-diff-reviewer` skill)
---

# /ai-diff-reviewer-generate-extension — provided by the `ai-diff-reviewer` skill

> Thin alias. The flow lives in the vendored `ai-diff-reviewer` skill — this
> file only routes to it, so there is a single source of truth and no drift.

## What to do

Route this invocation to the **generate-extension** sub-skill of the vendored
`ai-diff-reviewer` skill and follow it: read
`.agents/skills/ai-diff-reviewer/generate-extension/SKILL.md` and execute its
flow. The output lands in `.review/extension.md` — the same file CI's
`prompt-extension-file:` input reads, keeping local and CI reviews in parity.

> Other agents: invoke the sub-skill directly
> (`#ai-diff-reviewer-generate-extension` in Cursor/Codex/Gemini).
20 changes: 20 additions & 0 deletions .agents/commands/ai-diff-reviewer-open-pr.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
description: Draft the PR title + body from the current branch's diff (provided by the vendored `ai-diff-reviewer` skill)
---

# /ai-diff-reviewer-open-pr — provided by the `ai-diff-reviewer` skill

> Thin alias. The flow lives in the vendored `ai-diff-reviewer` skill — this
> file only routes to it, so there is a single source of truth and no drift.

## What to do

Route this invocation to the **open-pr** sub-skill of the vendored
`ai-diff-reviewer` skill and follow it: read
`.agents/skills/ai-diff-reviewer/open-pr/SKILL.md` and execute its flow
(Conventional-Commits title inference, structured body, `gh pr create`/`edit`).
Remember this repo's rule: every change ships through a branch + PR — never a
direct push to `main`.

> Other agents: invoke the sub-skill directly (`#ai-diff-reviewer-open-pr` in
> Cursor/Codex/Gemini).
21 changes: 21 additions & 0 deletions .agents/commands/ai-diff-reviewer-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
description: Re-run the AI Diff Reviewer CI workflow wizard (provided by the vendored `ai-diff-reviewer` skill)
---

# /ai-diff-reviewer-setup — provided by the `ai-diff-reviewer` skill

> Thin alias. The flow lives in the vendored `ai-diff-reviewer` skill — this
> file only routes to it, so there is a single source of truth and no drift.

## What to do

Route this invocation to the **setup** sub-skill of the vendored
`ai-diff-reviewer` skill and follow it: read
`.agents/skills/ai-diff-reviewer/setup/SKILL.md` and execute its flow. In this
repo the workflow already exists at `.github/workflows/pr-review.yml` (Flow B,
label-gated on `Ready`) — setup runs are reconfiguration passes, and
`.agents/skills/ai-diff-reviewer/setup/reference.md` doubles as the reference
manual for every `action.yml` input.

> Other agents: invoke the sub-skill directly (`#ai-diff-reviewer-setup` in
> Cursor/Codex/Gemini).
19 changes: 19 additions & 0 deletions .agents/commands/ai-diff-reviewer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
description: Run a local AI review of the current branch's diff (provided by the vendored `ai-diff-reviewer` skill)
---

# /ai-diff-reviewer — provided by the `ai-diff-reviewer` skill

> Thin alias. The flow lives in the vendored `ai-diff-reviewer` skill — this
> file only routes to it, so there is a single source of truth and no drift.

## What to do

Route this invocation to the vendored `ai-diff-reviewer` skill's default
local-review flow: read `.agents/skills/ai-diff-reviewer/SKILL.md` and execute
it (diff vs `main`, base prompt + `.review/extension.md`, findings table in the
CI-parity format). This is the same methodology CI runs on `Ready`-labeled PRs
via `.github/workflows/pr-review.yml`.

> Other agents: invoke the skill directly (`#ai-diff-reviewer` in
> Cursor/Codex/Gemini).
12 changes: 12 additions & 0 deletions .agents/docs/COMMANDS_REFERENCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,18 @@ The full plan-execute-verify loop, delegating to the vendored `deepworkplan` ski
| `/agent-create` | `../skills/deepworkplan/author/SKILL.md` | Create a new agent persona in `.agents/agents/<slug>.md`. | "Create an agent persona for the CI investigator role" |
| `/design-system` | `../skills/deepworkplan/addons/design-system/SKILL.md` | Refresh `docs/DESIGN.md` from the real design source (`display.py` + `DISPLAY_OUTPUT_BEST_PRACTICES.md`) via the DWP design-system addon. | "Re-sync DESIGN.md after refactoring `display.py`" |

## AI Diff Reviewer (Flow B)

Vendored skill at [`../skills/ai-diff-reviewer/`](../skills/ai-diff-reviewer/) (**v2.0.0**). CI gate: apply the **`Ready`** label on a PR to `main` (see [`.github/workflows/pr-review.yml`](../../.github/workflows/pr-review.yml); requires `CURSOR_API_KEY`). Extension: [`.review/extension.md`](../../.review/extension.md).

| Command / phrase | Routes to | What it does | Example trigger |
|------------------|-----------|--------------|-----------------|
| `/ai-diff-reviewer` | `../skills/ai-diff-reviewer/SKILL.md` | Local review of the current branch (verdict + findings); used by DWP Security Review when skill + extension are present | "Review my current branch" |
| `/ai-diff-reviewer-generate-extension` | `../skills/ai-diff-reviewer/generate-extension/SKILL.md` | Regenerate `.review/extension.md` from repo evidence | "Customize the review for this repo" |

This comment was marked as outdated.

| `/ai-diff-reviewer-setup` | `../skills/ai-diff-reviewer/setup/SKILL.md` | Re-run the CI workflow wizard | "Set up AI Diff Reviewer for this repo" |
| `/ai-diff-reviewer-open-pr` | `../skills/ai-diff-reviewer/open-pr/SKILL.md` | Draft PR title/body from the branch diff | "Open a PR for this branch" |
| `/ai-diff-reviewer-apply-review` | `../skills/ai-diff-reviewer/apply-review/SKILL.md` | Walk CI findings per-finding (apply / defer / skip); never commits | "Apply the CI review findings" |

Every plan ends with three mandatory final tasks (per the DWP spec): a **Security Review** of the plan's own changes (a critical finding blocks completion), a **Skills & Agents Discovery** pass, and an **Executive Report**.

State persists in [`.dwp/`](../../.dwp/) which is gitignored — only the placeholders `.dwp/plans/.gitkeep` and `.dwp/drafts/.gitkeep` are tracked.
Expand Down
15 changes: 14 additions & 1 deletion .agents/docs/skills_agents_catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ The full pack lives under [`.agents/skills/dailybot/`](../skills/dailybot/) (rou

### Deep Work Plan skill pack (vendored from [`DailybotHQ/deepworkplan-skill`](https://github.com/DailybotHQ/deepworkplan-skill))

The full pack lives under [`.agents/skills/deepworkplan/`](../skills/deepworkplan/) (router + 9 sub-skills + addons). Vendored at **v2.16.0**. The router auto-routes by intent — read [`skills/deepworkplan/SKILL.md`](../skills/deepworkplan/SKILL.md) and let it pick the right sub-skill. Each sub-skill is independently invocable, and each has a short `dwp-*` alias in [`.agents/commands/`](../commands/) for ergonomic typing.
The full pack lives under [`.agents/skills/deepworkplan/`](../skills/deepworkplan/) (router + 8 sub-skills + addons). Vendored at **v2.17.0**. The router auto-routes by intent — read [`skills/deepworkplan/SKILL.md`](../skills/deepworkplan/SKILL.md) and let it pick the right sub-skill. Each sub-skill is independently invocable, and each has a short `dwp-*` alias in [`.agents/commands/`](../commands/) for ergonomic typing.

| Slug | Procedure | Use when |
|------|-----------|----------|
Expand All @@ -53,6 +53,19 @@ The full pack lives under [`.agents/skills/deepworkplan/`](../skills/deepworkpla
| `skill-create` | [`skills/deepworkplan/author/SKILL.md`](../skills/deepworkplan/author/SKILL.md) | Creating a new skill in `.agents/skills/<slug>/` |
| `agent-create` | [`skills/deepworkplan/author/SKILL.md`](../skills/deepworkplan/author/SKILL.md) | Creating a new agent persona in `.agents/agents/<slug>.md` |
| `design-system` | [`skills/deepworkplan/addons/design-system/SKILL.md`](../skills/deepworkplan/addons/design-system/SKILL.md) | Refreshing [`docs/DESIGN.md`](../../docs/DESIGN.md) from the real design source (`display.py` + `DISPLAY_OUTPUT_BEST_PRACTICES.md`) — the `cli-output` profile of the DWP design-system addon |
| `ai-diff-reviewer` (addon) | [`skills/deepworkplan/addons/ai-diff-reviewer/SKILL.md`](../skills/deepworkplan/addons/ai-diff-reviewer/SKILL.md) | Opt-in DWP addon — wires Security Review to the vendored AI Diff Reviewer (Flow B: local + CI). See also the installed skill below. |

### AI Diff Reviewer (vendored from [`DailybotHQ/ai-diff-reviewer`](https://github.com/DailybotHQ/ai-diff-reviewer))

Vendored at **v2.0.0** under [`.agents/skills/ai-diff-reviewer/`](../skills/ai-diff-reviewer/). Flow B is enabled: local Security Review augmentation + CI gate via [`.github/workflows/pr-review.yml`](../../.github/workflows/pr-review.yml) (trigger label **`Ready`**; secret `CURSOR_API_KEY`; extension [`.review/extension.md`](../../.review/extension.md)).

| Slug | Procedure | Use when |
|------|-----------|----------|
| `ai-diff-reviewer` | [`skills/ai-diff-reviewer/SKILL.md`](../skills/ai-diff-reviewer/SKILL.md) | Running a local review on the current branch ("Review my current branch") |
| `ai-diff-reviewer-generate-extension` | [`skills/ai-diff-reviewer/generate-extension/SKILL.md`](../skills/ai-diff-reviewer/generate-extension/SKILL.md) | Regenerating [`.review/extension.md`](../../.review/extension.md) from repo evidence |
| `ai-diff-reviewer-setup` | [`skills/ai-diff-reviewer/setup/SKILL.md`](../skills/ai-diff-reviewer/setup/SKILL.md) | Re-running the CI workflow wizard |
| `ai-diff-reviewer-open-pr` | [`skills/ai-diff-reviewer/open-pr/SKILL.md`](../skills/ai-diff-reviewer/open-pr/SKILL.md) | Drafting a PR title/body from the branch diff |
| `ai-diff-reviewer-apply-review` | [`skills/ai-diff-reviewer/apply-review/SKILL.md`](../skills/ai-diff-reviewer/apply-review/SKILL.md) | Walking CI-posted findings per-finding (apply / defer / skip) |

Plans and drafts persist under [`.dwp/`](../../.dwp/) which is gitignored — only the `plans/.gitkeep` and `drafts/.gitkeep` placeholders are tracked. Full command catalog in [`COMMANDS_REFERENCE.md`](COMMANDS_REFERENCE.md), and the rationale in [`../../AGENTS.md`](../../AGENTS.md) "Working with Deep Work Plans".

Expand Down
Loading
Loading