-
Notifications
You must be signed in to change notification settings - Fork 26
docs: create plan/pending-prs.md with prioritized PR analysis #183
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,247 @@ | ||||||
| # Pending PR Analysis | ||||||
|
|
||||||
| **Generated:** 2026-04-08 | ||||||
| **Open PRs:** 29 | ||||||
| **Objective:** Identify the most load-bearing PRs, rank them for merge priority, and surface blockers and decomposition opportunities. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## 🎯 Executive Summary | ||||||
|
|
||||||
| Three PRs form the critical load-bearing spine of the backlog: | ||||||
|
|
||||||
| 1. **#97** — `npx aidd create` manifest-driven scaffolding (the largest, most complex PR; unblocks scaffold-related work) | ||||||
| 2. **#168** — `/aidd-pr` skill + eval infrastructure (unblocks CI/CD review automation and eval harness) | ||||||
| 3. **#80** — Skills Protocol migration from commands/rules (resolves naming/path inconsistencies that make many other PRs conflict) | ||||||
|
|
||||||
| Nine additional PRs are high-value and near-ready. The remaining PRs fall into docs-only, planning, or stale/blocked categories. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## 🔴 Tier 1 — Merge First (Load-Bearing) | ||||||
|
|
||||||
| These PRs are depended on by the most subsequent work, touch runtime code, or resolve conflicts that make other PRs harder to merge. | ||||||
|
|
||||||
| ### #97 — `npx aidd create` + `scaffold-cleanup` | ||||||
| - **Branch:** `claude/execute-aidd-create-epic-orEHx` | ||||||
| - **Size:** +5,911 / -153 lines (largest PR in backlog) | ||||||
| - **State:** Open (not draft) | ||||||
| - **Why load-bearing:** Implements the `create` and `scaffold-cleanup` CLI commands — the primary user-facing scaffolding feature. Multiple other PRs (#71, #178) depend on or patch this surface. | ||||||
| - **Files touched:** `bin/aidd.js`, `lib/scaffold-resolver.js`, `lib/agents-index.js`, `ai/scaffolds/`, `AGENTS.md`, `README.md`, e2e tests | ||||||
| - **Risk:** Large diff; e2e tests included. Needs review of `scaffold-resolver.js` URL-handling paths and remote tarball logic. | ||||||
| - **Decomposition opportunity:** Could split into (a) named scaffold support only, (b) file:// URI support, (c) HTTPS/remote URI + tarball handling. Each is independently testable. | ||||||
| - **Blocker:** None identified. Needs review pass. | ||||||
|
|
||||||
| ### #168 — `/aidd-pr` skill, eval infrastructure, rename `/aidd-requirements` | ||||||
| - **Branch:** `cursor/aidd-config-json-support-24c1` | ||||||
| - **Size:** +1,098 / -48 lines | ||||||
| - **State:** Open (not draft) | ||||||
| - **Why load-bearing:** Adds the `/aidd-pr` skill (used by agents to create PRs), the `aidd-parallel` skill, the riteway-ai skill, and the eval test harness (`.github/workflows/ai-eval.yml`). The eval infrastructure directly supports CI quality gates for every subsequent skill PR. | ||||||
| - **Files touched:** `ai/skills/aidd-pr/`, `ai/skills/aidd-parallel/`, `ai/skills/aidd-requirements/`, `ai/skills/aidd-riteway-ai/`, `ai-evals/`, `.github/workflows/ai-eval.yml` | ||||||
| - **Risk:** Medium. Workflow permissions and `ANTHROPIC_API_KEY` secret required. | ||||||
| - **Decomposition opportunity:** Could extract the eval infrastructure (`.github/` + `ai-evals/`) as its own PR for faster merge of the CI piece. | ||||||
|
|
||||||
| ### #80 — Migrate commands/rules → Skills Protocol | ||||||
| - **Branch:** `2witstudios:main` | ||||||
| - **Size:** +718 / -652 lines | ||||||
| - **State:** Open (not draft), external fork | ||||||
| - **Why load-bearing:** Removes `ai/commands/` and `ai/rules/` directories and migrates to `ai/skills/`. Many open PRs still reference the old paths — merging this will force resolution of those conflicts and establish the canonical directory structure. | ||||||
| - **Risk:** High conflict surface. All PRs adding to `ai/commands/` or `ai/rules/` will need rebasing after this merges. | ||||||
| - **Recommendation:** Review carefully for completeness; merge before the skills-adding PRs to reduce rework. | ||||||
|
|
||||||
| --- | ||||||
|
|
||||||
| ## 🟠 Tier 2 — Merge Next (High Value, Lower Risk) | ||||||
|
|
||||||
| These are focused, well-scoped PRs that add real capability with minimal conflict risk. | ||||||
|
|
||||||
| ### #129 — `fix(tdd)`: add cross-reference to requirements.mdc | ||||||
| - **Size:** +1 / -0 lines | ||||||
| - **State:** Open | ||||||
| - **Why first:** Trivially small, closes #127, zero conflict risk. Merge immediately. | ||||||
|
|
||||||
| ### #144 — Avoid user interaction in review | ||||||
| - **Size:** +1 / -1 lines | ||||||
| - **State:** Open | ||||||
| - **Why next:** One-line doc fix to `review.mdc`. No conflicts. Merge immediately. | ||||||
|
|
||||||
| ### #26 — Add debug slash command | ||||||
| - **Size:** +20 / -0 lines | ||||||
| - **State:** Open | ||||||
| - **Assessment:** Small, high-utility command addition. Clean. | ||||||
|
|
||||||
| ### #27 — Add brainstorm slash command | ||||||
| - **Size:** +35 / -0 lines | ||||||
| - **State:** Open | ||||||
| - **Assessment:** Small, widely useful command. Clean. | ||||||
|
|
||||||
| ### #154 — CI: automated PR review with Claude | ||||||
| - **Branch:** `add-aidd-review-action` | ||||||
| - **Size:** +114 / -0 lines | ||||||
| - **State:** Open | ||||||
| - **Assessment:** Adds `.github/workflows/aidd-review-claude.yml`. Requires `ANTHROPIC_API_KEY` secret. Low conflict risk; high leverage once merged (reviews all subsequent PRs automatically). | ||||||
| - **Prerequisite:** Confirm secret is configured in repo settings. | ||||||
|
|
||||||
| ### #178 — Fix `SCAFFOLD_MANIFEST.yml` (underscore) in tarball downloads | ||||||
|
||||||
| ### #178 — Fix `SCAFFOLD_MANIFEST.yml` (underscore) in tarball downloads | |
| ### #178 — Fix `SCAFFOLD_MANIFEST.yml` → `SCAFFOLD-MANIFEST.yml` handling in tarball downloads |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Executive Summary says “Nine additional PRs are high-value and near-ready”, but Tier 2 lists 10 PRs (#129, #144, #26, #27, #154, #178, #165, #170, #171, #179). Update the count (or adjust Tier 2 membership) so the summary matches the detailed list.