feat(aidd-refine): adversarial and advisory agents
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 55/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- typescript
- Domain
- ai-infra-agents, documentation, testing-qa, tooling
Research direction
Start with plugins/aidd-refine/skills/02-challenge/SKILL.md, plugins/aidd-dev/agents/checker.md and executor.md, and docs/ARCHITECTURE.md. Trace the existing install/translate pipeline and its unit fixtures, then add the two agent sources and thin actions. Done means CI covers translation, reports enforce severity caps and floors, agents remain read-only, and README explains when to use each approach.
Written by the indexing model from the issue text.
Description
Problem
Refine exposes in-session recipes (challenge) but not isolated adversarial (attack assumptions, vacuous acceptance criteria, bypasses) and advisory (strengthen, prioritize) agents. Spec/plan stress-testing and constructive second opinions are improvised or skipped. The checker review path is a different job.
Scope
- Agents
adversarialandadvisoryunderaidd-refine/agents/(canonical source format). - Multi-tool presence = existing install/translate pipeline only (materialize into each installed tool’s native agent paths and formats). No symlinks across tool trees. Hosts never need to read
.aidd/for discovery. - Thin skill/actions to run each agent on a named artifact (spec, plan, brief) with a fixed report shape.
- Severity floor + max findings (cap noise before any later specialist wiring).
- Read-only; never implement; never invoke orchestrator skills.
- Document when to use
challengevs adversarial vs advisory.
Standalone value: Spec/plan stress-test and second opinion without waiting for pluggable specialists.
Acceptance criteria
- Both agent source files ship in the plugin.
- Translator/unit fixture: canonical agent → at least one non-source target format (or identity when same format) — CI-able, not “UI discoverable”.
- Adversarial: findings with severity; no writes; respects cap/floor.
- Advisory: ordered recommendations; no writes; does not alone set a ship-blocking verdict.
- README: challenge vs adversarial vs advisory.
- Agents do not implement fixes or invoke orchestrator skills.
Prior art in this repo
plugins/aidd-refine/skills/02-challenge/SKILL.md— in-session challenge recipe (not isolated agents)plugins/aidd-dev/agents/checker.md,plugins/aidd-dev/agents/executor.md— existing agent split (judge vs build)docs/ARCHITECTURE.md(~L157–160) — agents invoke recipes; cross-plugin by capability- #548 — plan drift / challenge + acceptance-criteria gaps (user report)
Relations
Intended graph (same fields as GitHub parent / blocked-by / blocks). Formal GraphQL edges need maintainer write — see comment on #584.
| Field | Value |
|---|---|
| parent | #584 |
| blocked-by | — |
| blocks | #591 |
| related | #548 |
| MVP | 2 |
Out of scope
- Auto-wiring into every review (pluggable specialists child)
- Project-local agents under
.aidd/agents(materialize child) - Symlink-based multi-tool layout
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 19h 38m
- Merged PRs (30d)
- 108
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ai-driven-dev/framework
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one round Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
ai-driven-dev/framework#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
All issues in ai-driven-dev/framework
Similar issues
-
VerificationGate: ATTRIBUTION quote guard never matches a normal quotation (\b around the quote) Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
danielmiessler/LifeOS#2234 ·
-
T: Bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
Difficulty 1/5 Under an hour Newbie friendliness 85/100
-
Mend: dependency security vulnerability untriaged
Difficulty 2/5 1-3 hours Newbie friendliness 70/100