Skip to content
Skills Library
Programming · Automation

aidd-loop

/aidd-loop

Enforces loop-mode discipline for implement/review/qa (packs, scope, no questions). Use when loop stages require bounded scope and retry policy. Do not use when direct stage execution belongs to `implement`, `review`, or `qa` stage skills.

Licence
MIT
Last repository change
08.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
21
Scripts
18
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 18 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: runtime/claude_stream_render.py, runtime/loop_block_policy.py, runtime/loop_pack.py, runtime/loop_pack_parts/__init__.py, runtime/loop_pack_parts/core.py, runtime/loop_run.py, runtime/loop_run_parts/__init__.py, runtime/loop_run_parts/core.py, runtime/loop_step.py, runtime/loop_step_parts/__init__.py, runtime/loop_step_parts/core.py, runtime/loop_step_policy.py, runtime/loop_step_stage_chain.py, r

What it does and when to use it

Enforces loop-mode discipline for implement/review/qa (packs, scope, no questions). Use when loop stages require bounded scope and retry policy. Do not use when direct stage execution belongs to `implement`, `review`, or `qa` stage skills.

Original author description

Enforces loop-mode discipline for implement/review/qa (packs, scope, no questions). Use when loop stages require bounded scope and retry policy. Do not use when direct stage execution belongs to `implement`, `review`, or `qa` stage skills.

How it works

  1. Loop discipline
  2. Preload matrix v2
  3. Canonical shared Python entrypoints
  4. Command contracts
  5. Additional resources
Original SKILL.md headings · 47 lines, 382 words
SKILL.md preview
---
name: aidd-loop
description: Enforces loop-mode discipline for implement/review/qa (packs, scope, no questions). Use when loop stages require bounded scope and retry policy. Do not use when direct stage execution belongs to `implement`, `review`, or `qa` stage skills.
lang: en
model: inherit
user-invocable: false
---

Follow `feature-dev-aidd:aidd-core` for output contract and DocOps.

## Loop discipline
1. Read order: loop pack -> review pack (if any) -> fix_plan.json when verdict=REVISE -> rolling context pack.
2. Excerpt-first: do not read full PRD/plan/tasklist/spec when the loop pack excerpt covers Goal/DoD/Boundaries/Expected paths/Size budget/Tests/Acceptance.
3. No questions in loop-mode; record blockers/handoff instead.
4. REVISE: reuse the same scope, follow fix_plan.json, and do not widen boundaries.
5. Scope guard: out-of-scope -> WARN + handoff; forbidden -> BLOCKED. Never expand boundaries yourself.
6. Tests: follow loop pack or reviewer policy; do not invent new test requirements.
7. No large logs/diffs in chat; link to `aidd/reports/**`.
8. Block policy: `strict` fail-fast by default; `strict_recoverable_reason_codes` may explicitly enable bounded retries for selected reasons (for example `no_tests_hard`).
9. `ralph` uses policy matrix v2 (`hard_block|recoverable_retry|warn_continue`) with bounded retries for recoverable reasons.
10. For recoverable blocked retries, emit observability fields: `recoverable_blocked`, `recovery_path`, `retry_attempt`, plus `ralph_reason_class|strict_recoverable_reason_class`.
11. Scope mismatch fallback is telemetry-only (`scope_mismatch_non_authoritative=1`): emit `expected_scope_key`/`selected_scope_key`; do not treat mismatched fallback as authoritative transition input.

## Preload matrix v2
- Roles: `implementer`, `reviewer`, `qa`.
- This skill must not be preloaded for other subagents.

## Canonical shared Python entrypoints
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_pack.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_step.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_run.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/preflight_result_validate.py`
- `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/output_contract.py`
- Preflight preparation is stage-chain-internal and not an operator command.

## Command contracts
### `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_pack.py`
- When to run: before loop stage execution to assemble bounded evidence input.
- Inputs: ticket/scope context and available stage artifacts (`readmap`, `review pack`, context pack).
- Outputs: deterministic loop pack summary for implement/review/qa orchestration.
- Failure mode: non-zero exit when required upstream artifacts are missing or malformed.
- Next action: repair missing prerequisites and rerun pack generation.

### `python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_run.py`
- When to run: stage-chain-orchestrated loop execution for bounded stage retries.
- Inputs: loop mode/profile, ticket/scope context, and stage-specific payloads.
- Outputs: loop execution status with deterministic retry/blocked metadata.
- Failure mode: non-zero exit on invalid loop payload, policy violation, or unrecoverable blocked condition.
- Next action: apply fix plan or handoff policy action, then rerun with unchanged scope.

## Additional resources
- Loop stage-chain reference: [reference.md](reference.md) (when: stage-chain path/fallback behavior needs clarification; why: confirm canonical chain and bounded recovery policy).
- Loop pack template source: [templates/loop-pack.template.md](templates/loop-pack.template.md) (when: loop pack format is unclear; why: confirm canonical sections seeded by init/runtime).
Files in this package (21)
  • SKILL.md 4 KB
  • reference.md 1 KB
  • runtime/claude_stream_render.py 6 KB
  • runtime/loop_block_policy.py 7 KB
  • runtime/loop_pack.py 1 KB
  • runtime/loop_run.py 1 KB
  • runtime/loop_step.py 1 KB
  • runtime/loop_step_policy.py 8 KB
  • runtime/loop_step_stage_chain.py 29 KB
  • runtime/loop_step_stage_result.py 14 KB
  • runtime/marker_semantics.py 3 KB
  • runtime/output_contract.py 11 KB
  • runtime/preflight_prepare.py 31 KB
  • runtime/preflight_result_validate.py 10 KB
  • runtime/loop_pack_parts/__init__.py 1 KB
  • runtime/loop_pack_parts/core.py 39 KB
  • runtime/loop_run_parts/__init__.py 1 KB
  • runtime/loop_run_parts/core.py 113 KB
  • runtime/loop_step_parts/__init__.py 1 KB
  • runtime/loop_step_parts/core.py 98 KB
  • templates/loop-pack.template.md 1 KB

Versions

The database has no other skills named aidd-loop.

Database snapshot: 13.11.2026 · package version bddcc763d955 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100aidd-policy
    Defines the shared policy contract for output format, read discipline, question format, and loop safety. Use when applying cross-stage policy rules. Do not use when the request is to execute runtime orchestration from `aidd-core` or `aidd-loop`.
  • 90implement
    Executes implement-stage loop workflow for the next scoped work item through stage-chain orchestration. Use when implement stage enters loop mode. Do not use when the request is focused on findings validation in `review` or verification/reporting in `qa`.
  • 100aidd
    Use before any change in a repository with .aidd/config.yaml (or an AGENTS.md that names aidd): a bug fix, feature, refactor, commit, push, or PR/MR. Also when the user names aidd, a Spec, a route (minor, normal, major, emergency), or a risk rule.
  • 100code-review
    Practice skill: review a diff against its Spec. Use in an aidd repository when reading a PR/MR as a reviewer, or someone asks to review a diff or whether it is ready to merge.
  • 90implement
    Implement a single planned issue, optionally inside a bounded autonomous loop. Use to execute one unit of an approved plan.
  • 100review-loop
    Reviews a change with another vendor's model in a loop until it approves. Use when the user asks for a review or code review, says 'sol loop', or before opening a pull request.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.