Skip to content
Skills Library
AI & agents · Automation

00-async-dev

/00-async-dev

Drive the async-dev pipeline from one entry point, whether setup, run, or review. Use when the user wants to install async dev, run a ready issue, or address PR review comments, or on a webhook trigger. Not for plain status checks.

Repository
framework ↗
Licence
MIT
Last repository change
26.10.2026

Assessment and security

90/ 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.
Content25 / 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
31
Scripts
2
HTML comments
0
URLs in SKILL.md
0
Deprecation

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

Licence

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

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

Scripts: assets/setup/local-daemon-template.sh, assets/setup/local-poll-template.sh

What it does and when to use it

Drive the async-dev pipeline from one entry point, whether setup, run, or review. Use when the user wants to install async dev, run a ready issue, or address PR review comments, or on a webhook trigger. Not for plain status checks.

Arguments

/00-async-dev setup | run | review
Original author description

Drive the async-dev pipeline from one entry point, whether setup, run, or review. Use when the user wants to install async dev, run a ready issue, or address PR review comments, or on a webhook trigger. Not for plain status checks.

How it works

  1. Iron rule
  2. Routing: hybrid contract
  3. Sub-flows
  4. Rules
  5. References
  6. Assets
  7. Test
Original SKILL.md headings · 127 lines, 1,081 words
SKILL.md preview
---
name: 00-async-dev
description: Drive the async-dev pipeline from one entry point, whether setup, run, or review. Use when the user wants to install async dev, run a ready issue, or address PR review comments, or on a webhook trigger. Not for plain status checks.
argument-hint: setup | run | review
---

# Async-dev

Single skill that drives the async development pipeline end to end. Three sub-flows live inside, accessed through one router:

| Sub-flow | When                                                                                          |
| -------- | --------------------------------------------------------------------------------------------- |
| Setup    | Repo not yet configured for async dev; user wants to install.                                 |
| Run      | An issue is labeled `to-implement` (or commented `@claude /implement`); no open PR closes it. |
| Review   | A PR is labeled `to-review` (or commented `@claude /review`); change requests pending.        |

## Iron rule

**You are the router until you commit to a sub-flow. Once committed, run that sub-flow's actions in order; do not jump back to routing mid-flow.**

## Routing: hybrid contract

Walk in order. First match wins.

1. **Argument override.** If the arguments contain exactly `setup`, `run`, or `review` (case-insensitive, standalone token), route there immediately. This is the explicit override the CI workflow uses.
2. **Trigger env.** When invoked from CI (`GITHUB_EVENT_NAME` set):
   - Label payload `to-implement` → `run`.
   - Label payload `to-review` → `review`.
   - Comment body matches `@claude /implement` (or `/aidd-dev:02-implement`) → `run`.
   - Comment body matches `@claude /review` → `review`.
3. **Repo state.**
   - Missing `.github/workflows/aidd-async.yml` AND missing `.claude/aidd-orchestrator.json` → `setup`.
   - Open PR closes the referenced issue → `review`.
   - Fresh issue with no linked PR + intent to implement → `run`.
4. **Natural-language intent.** Verbs in the user prompt:
   - `install / configure / set up / bootstrap / rotate config` → `setup`.
   - `implement / run / process / handle queue / claude on issue` → `run`.
   - `address review / iterate on PR / fix comments / handle review` → `review`.

**Tie-break:** most-specific signal wins (PR number > label > free-text keyword > config absence).

**If none of the above resolves**, surface the three sub-flows with one-line triggers and ask the human which to run. **Never proceed blindly.**

**If repo state contradicts intent** (e.g. user says "run" but `.claude/aidd-orchestrator.json` is absent), surface the conflict before delegating; never silently switch.

See `references/routing.md` for the full decision tree, signal precedence, and edge cases.

## Sub-flows

### Setup (11 actions)

Sets up async-dev in a repo. Detects context, asks for runtime parameters, generates artefacts, bootstraps labels, installs user-scope plugins (local mode), configures secrets (remote mode), schedules the poll routine (local mode), commits and pushes the generated files, and offers a smoke test on the chosen issue.

| #   | Action                            | Role                                                                                          |
| --- | --------------------------------- | --------------------------------------------------------------------------------------------- |
| 01  | `detect-context`                  | Identify repo, default branch, existing config, CI permissions                                |
| 02  | `ask-config`                      | Collect runtime parameters (mode, auth, labels, schedule, agents)                             |
| 03  | `generate-workflow`               | Emit `.github/workflows/aidd-async.yml` from `assets/setup/workflow-template.yml`             |
| 04  | `generate-local-script`           | Emit poll/daemon scripts (local mode only) from `assets/setup/local-*-template.sh`            |
| 05  | `write-config`                    | Persist `.claude/aidd-orchestrator.json` from `assets/setup/config-template.json`             |
| 06  | `bootstrap-labels`                | Create `to-implement` / `to-review` / `claude/*` labels via `gh`                              |
| 07  | `install-user-scope-plugins`      | Install `aidd-orchestrator` + `aidd-dev` at user scope (local mode)                           |
| 08  | `configure-remote-secrets`        | Sync `CLAUDE_CODE_OAUTH_TOKEN`, `AIDD_BOT_TOKEN`, etc. (remote mode)                          |
| 09  | `bootstrap-scheduling`            | Schedule the poll routine (local) or rely on workflow webhook (remote)                        |
| 10  | `commit-and-push`                 | Stage generated files, conventional-commit, push                                              |
| 11  | `smoke-test`                      | Label a throwaway issue with `to-implement`; verify the pipeline reacts                       |

Files: `actions/setup/01-detect-context.md` ... `actions/setup/11-smoke-test.md`.

Default flow: `01 → 02 → 03 → 04 → 05 → 06 → 07 → 08 → 09 → 10 → 11`. Actions self-skip when their preconditions are not met (e.g. `07` skips in remote mode, `08` skips in local mode).

### Run (6 actions)

Executes one orchestration cycle on a fresh issue. Reads ready issues, resolves blockers, acquires the lock label, hands the implementation to the active SDLC orchestration capability, observes the resulting git and VCS state, and emits a `run-result.json` summary the workflow's post-job consumes.

| #   | Action            | Role                                                                                           |
| --- | ----------------- | ---------------------------------------------------------------------------------------------- |
| 01  | `poll-ready`      | Find the next issue with `to-implement`, no `claude/working`, no open closing PR               |
| 02  | `resolve-deps`    | Check linked issues / dependencies; abort if blocked                                           |
| 03  | `acquire-lock`    | Apply `claude/working` label; refuse if already held                                           |
| 04  | `check-sdlc`      | Verify an SDLC orchestration capability is loaded                                              |
| 05  | `delegate-sdlc`   | Hand the issue to the SDLC capability; observe outcome                                         |
| 06  | `write-audit`     | Emit `run-result.json` for the workflow's post-job                                             |

Files: `actions/run/01-poll-ready.md` ... `actions/run/06-write-audit.md`.

Default flow: `01 → 02 → 03 → 04 → 05 → 06`. One cycle per ready issue.

### Review (4 actions)

Closes the loop after a PR is opened by the run flow. Detects when to keep auto-fixing and when to hand off to a human. Idempotent on re-runs.

| #   | Action               | Role                                                                                       |
| --- | -------------------- | ------------------------------------------------------------------------------------------ |
| 01  | `collect-comments`   | Read all PR + linked-issue comments newer than the last bot activity                       |
| 02  | `detect-stop`        | Decide stop vs continue using `references/review/stop-conditions.md`                       |
| 03  | `fix-iteration`      | Delegate fixes to the SDLC capability; reply to each addressed comment                     |
| 04  | `finalize`           | Resolve threads, post the structured summary, set `claude/awaiting-review` or `blocked`    |

Files: `actions/review/01-collect-comments.md` ... `actions/review/04-finalize.md`.

Default flow: `01 → 02 → (03 → 01 loop if continue) → 04`. Stop conditions in `references/review/stop-conditions.md`.

## Rules

- Exactly one sub-flow runs per invocation. The router commits, then runs that sub-flow to completion.
- Never inline a sub-flow's logic at the router level. The router decides; the actions execute.
- Each action enforces its own pre-flight checks and exit codes. The router never enforces post-conditions.
- If a sub-flow aborts, surface the exit state; do not retry by switching sub-flows.
- For batch invocations (e.g. multiple ready issues), the workflow re-invokes the skill once per item; the router does not loop.

## References

- `references/routing.md` - full decision tree, signal precedence, conflict resolution.
- `references/setup/auth-modes.md` - local vs remote auth contracts.
- `references/setup/claude-action-auth.md` - `claude-code-action` token setup.
- `references/setup/local-mode-scheduling.md` - poll routine options.
- `references/review/stop-conditions.md` - when the review loop hands off to a human.

## Assets

Setup-only templates copied into the target repo by the setup sub-flow:

- `assets/setup/workflow-template.yml` - `.github/workflows/aidd-async.yml` skeleton.
- `assets/setup/local-poll-template.sh` - local-mode poll script.
- `assets/setup/local-daemon-template.sh` - local-mode daemon script.
- `assets/setup/config-template.json` - `.claude/aidd-orchestrator.json` skeleton.

## Test

Each sub-flow's final action carries a `## Test` block that exercises the full sub-flow with mocked dependencies.
Files in this package (31)
  • SKILL.md 9 KB
  • actions/review/01-collect-comments.md 3 KB
  • actions/review/02-detect-stop.md 2 KB
  • actions/review/03-fix-iteration.md 3 KB
  • actions/review/04-finalize.md 2 KB
  • actions/run/01-poll-ready.md 1 KB
  • actions/run/02-resolve-deps.md 1 KB
  • actions/run/03-acquire-lock.md 1 KB
  • actions/run/04-check-sdlc.md 1 KB
  • actions/run/05-delegate-sdlc.md 5 KB
  • actions/run/06-write-audit.md 2 KB
  • actions/setup/01-detect-context.md 1 KB
  • actions/setup/02-ask-config.md 5 KB
  • actions/setup/03-generate-workflow.md 3 KB
  • actions/setup/04-generate-local-script.md 1 KB
  • actions/setup/05-write-config.md 1 KB
  • actions/setup/06-bootstrap-labels.md 2 KB
  • actions/setup/07-install-user-scope-plugins.md 4 KB
  • actions/setup/08-configure-remote-secrets.md 7 KB
  • actions/setup/09-bootstrap-scheduling.md 3 KB
  • actions/setup/10-commit-and-push.md 2 KB
  • actions/setup/11-smoke-test.md 3 KB
  • assets/setup/config-template.json 1 KB
  • assets/setup/local-daemon-template.sh 1 KB
  • assets/setup/local-poll-template.sh 2 KB
  • assets/setup/workflow-template.yml 16 KB
  • references/routing.md 5 KB
  • references/review/stop-conditions.md 2 KB
  • references/setup/auth-modes.md 2 KB
  • references/setup/claude-action-auth.md 2 KB
  • references/setup/local-mode-scheduling.md 7 KB

Versions

The database has no other skills named 00-async-dev.

Database snapshot: 13.11.2026 · package version 23ff3ae75c88 (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

  • 100runway-dev-setup
    Use when the user installs or starts using Runway Dev, needs to sign in or create a Developer Portal account, connect Dev MCP, verify account/project access, or finish setup after a developer_not_found error. Guide the user through the browser steps and continue with the task once setup succeeds.
  • 100dev-pipeline
    Multi-agent development pipeline (Orchestrator + workers + consensus vote). Use when the user asks to "build a feature", "fix a bug with the pipeline", or "run the dev pipeline". Triggers on "dev pipeline", "multi-agent pipeline", "run pipeline".
  • 100dev-setup
    Use to install the plugin's rules into your AI tool and prepare a repo. Triggers include "set up the plugin", "dev-setup", and the end of the start skill. Idempotent, safe to rerun any time to refresh the rules.
  • 100async-pr-review
    Trigger this skill when the user wants to start an asynchronous PR review, run background checks on a PR, or check the status of a previously started async PR review.
  • 90delegate-backlog
    Delegate an approved backlog to a real async coding agent (GitHub Copilot coding agent) so several stories are worked in parallel — one branch and PR per issue — then re-apply the kit's quality via pr-review/fix-pr on the resulting PRs. The async, throughput-first alternative to…
  • 90trigger-dev
    Trigger.dev expert for background jobs, AI workflows, and reliable async execution with excellent developer experience and TypeScript-first design. Use when: trigger.dev, trigger dev, background ta...

Feedback and reports

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