You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .claude/CLAUDE.md
+10-8Lines changed: 10 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,23 +6,25 @@ Rust library for NP-hard problem reductions. Implements computational problems w
6
6
## Skills
7
7
These repo-local skills live under `.claude/skills/*/SKILL.md`.
8
8
9
+
-[run-pipeline](skills/run-pipeline/SKILL.md) -- Pick a Ready issue from the GitHub Project board, move it through In Progress -> issue-to-pr -> Review pool. One issue at a time; forever-loop handles iteration.
9
10
-[issue-to-pr](skills/issue-to-pr/SKILL.md) -- Convert a GitHub issue into a PR with an implementation plan. One item per PR: `[Rule]` issues require both models to exist on `main`; never bundle model + rule in the same PR.
10
11
-[add-model](skills/add-model/SKILL.md) -- Add a new problem model. Can be used standalone (brainstorms with user) or called from `issue-to-pr`.
11
12
-[add-rule](skills/add-rule/SKILL.md) -- Add a new reduction rule. Can be used standalone (brainstorms with user) or called from `issue-to-pr`.
12
-
-[review-implementation](skills/review-implementation/SKILL.md) -- Review implementation completeness by dispatching parallel subagents (structural + quality) with fresh context. Auto-detects new models/rules from git diff. Called automatically at the end of `add-model`/`add-rule`, after each `executing-plans` batch, or standalone via `/review-implementation`.
13
-
-[fix-pr](skills/fix-pr/SKILL.md) -- Resolve PR review comments (user + Copilot), fix CI failures, and address codecov coverage gaps. Uses `gh api` for codecov (not local `cargo-llvm-cov`).
13
+
-[review-structural](skills/review-structural/SKILL.md) -- Project-specific structural completeness check: model/rule checklists, build, semantic correctness, issue compliance. Read-only, no code changes. Called by `review-pipeline`.
14
+
-[review-quality](skills/review-quality/SKILL.md) -- Generic code quality review: DRY, KISS, cohesion/coupling, test quality, HCI. Read-only, no code changes. Called by `review-pipeline`.
15
+
-[fix-pr](skills/fix-pr/SKILL.md) -- Resolve PR review comments, fix CI failures, and address codecov coverage gaps. Uses `gh api` for codecov (not local `cargo-llvm-cov`).
14
16
-[write-model-in-paper](skills/write-model-in-paper/SKILL.md) -- Write or improve a problem-def entry in the Typst paper (standalone, for improving existing entries). Core instructions are inlined in `add-model` Step 6.
15
17
-[write-rule-in-paper](skills/write-rule-in-paper/SKILL.md) -- Write or improve a reduction-rule entry in the Typst paper (standalone, for improving existing entries). Core instructions are inlined in `add-rule` Step 5.
16
18
-[release](skills/release/SKILL.md) -- Create a new crate release. Determines version bump from diff, verifies tests/clippy, then runs `make release`.
17
19
-[check-issue](skills/check-issue/SKILL.md) -- Quality gate for `[Rule]` and `[Model]` issues. Checks usefulness, non-triviality, correctness of literature, and writing quality. Posts structured report and adds failure labels.
20
+
-[fix-issue](skills/fix-issue/SKILL.md) -- Fix quality issues found by check-issue — auto-fixes mechanical problems, brainstorms substantive issues with human, then re-checks and moves to Ready.
18
21
-[topology-sanity-check](skills/topology-sanity-check/SKILL.md) -- Run sanity checks on the reduction graph: detect orphan (isolated) problems and redundant reduction rules.
19
22
-`topology-sanity-check orphans` -- Detect isolated problem types (runs `examples/detect_isolated_problems.rs`)
-`topology-sanity-check redundancy [source target]` -- Check for dominated reduction rules
22
-
-[project-pipeline](skills/project-pipeline/SKILL.md) -- Pick a Ready issue from the GitHub Project board, move it through In Progress -> issue-to-pr --execute -> Review pool.
23
-
-[review-pipeline](skills/review-pipeline/SKILL.md) -- Pick a PR from Review pool column, fix Copilot review comments, run structural completeness check, fix CI, run agentic feature tests, move to Final review.
25
+
-[review-pipeline](skills/review-pipeline/SKILL.md) -- Agentic review for PRs in Review pool: runs structural check, quality check, and agentic feature tests (no code changes), posts combined verdict, always moves to Final review.
24
26
-[propose](skills/propose/SKILL.md) -- Interactive brainstorming to help domain experts propose a new model or rule. Asks one question at a time, uses mathematical language (no programming jargon), and files a GitHub issue.
25
-
-[final-review](skills/final-review/SKILL.md) -- Interactive maintainer review for PRs in "Final review" column. Assesses usefulness, safety, completeness, quality ranking, then merge or hold.
27
+
-[final-review](skills/final-review/SKILL.md) -- Interactive maintainer review for PRs in "Final review" column. Merges main, walks through agentic review bullets with human, then merge or hold.
26
28
-[dev-setup](skills/dev-setup/SKILL.md) -- Interactive wizard to install and configure all development tools for new maintainers.
27
29
-[tutorial](skills/tutorial/SKILL.md) -- Interactive tutorial — walk through the pred CLI to explore, reduce, and solve NP-hard problems. No Rust internals.
28
30
@@ -62,10 +64,10 @@ make run-issue N=42 # Run issue-to-pr --execute for a GitHub issue
62
64
make run-pipeline # Pick next Ready issue from project board, implement, move to Review pool
63
65
make run-pipeline N=97 # Process a specific issue from the project board
64
66
make run-pipeline-forever # Poll Ready column, run-pipeline when new issues appear
65
-
make run-review # Pick next PR from Review pool column, fix Copilot comments, fix CI, run agentic tests
67
+
make run-review # Pick next PR from Review pool column, run agentic review, move to Final review
66
68
make run-review N=570 # Process a specific PR from the Review pool column
67
-
make run-review-forever # Poll Review pool, auto-request Copilot reviews, dispatch run-review when reviewed
68
-
make copilot-review # Request Copilot code review on current PR (requires: gh extension install ChrisCarini/gh-copilot-review)
69
+
make run-review-forever # Poll Review pool for eligible PRs, dispatch run-review
70
+
make copilot-review #(Optional) Request Copilot code review on current PR
69
71
make release V=x.y.z # Tag and push a new release (CI publishes to crates.io)
70
72
# Set RUNNER=claude to use Claude instead of Codex (default: codex)
If running standalone (not inside `make run-plan`), invoke [review-implementation](../review-implementation/SKILL.md) to verify all structural and semantic checks pass. When running inside a plan, the outer orchestrator handles the review.
262
+
Structural and quality review is handled by the `review-pipeline` stage, not here. The run stage just needs to produce working code.
Copy file name to clipboardExpand all lines: .claude/skills/add-rule/SKILL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -175,7 +175,7 @@ cargo run --example export_schemas # Generate problem schemas for docs/paper bu
175
175
make test clippy # Must pass
176
176
```
177
177
178
-
If running standalone (not inside `make run-plan`), invoke [review-implementation](../review-implementation/SKILL.md) to verify all structural and semantic checks pass. When running inside a plan, the outer orchestrator handles the review.
178
+
Structural and quality review is handled by the `review-pipeline` stage, not here. The run stage just needs to produce working code.
@@ -54,7 +54,7 @@ For each tool in the **Core Tools** table of `dependencies.md`:
54
54
3.**If missing** → print the install command for the detected platform, then execute it
55
55
56
56
After all core tools are done, ask:
57
-
> "Core tools are installed. Do you also want to set up the AI pipeline tools (gh, claude, pred, copilot-review)?"
57
+
> "Core tools are installed. Do you also want to set up the AI pipeline tools (gh, claude, pred)?"
58
58
59
59
-**Yes** → proceed to Step 4
60
60
-**No** → skip to Step 6
@@ -148,14 +148,7 @@ If this fails, the user likely needs org-level project scopes:
148
148
gh auth refresh -s read:project,project
149
149
```
150
150
151
-
**6c: Test `make run-review` prerequisites**
152
-
153
-
```bash
154
-
# Verify gh-copilot-review works
155
-
gh copilot-review --help
156
-
```
157
-
158
-
**6d: Test claude CLI**
151
+
**6c: Test claude CLI**
159
152
160
153
```bash
161
154
claude --version
@@ -179,7 +172,7 @@ If all pipeline checks pass, explain the project-based contribution pipeline:
179
172
> Picks the next **Ready** issue, moves it to **In Progress**, implements it (using `/issue-to-pr` → `/add-model` or `/add-rule`), creates a PR, then moves it to **Review pool**.
180
173
>
181
174
> ### `make run-review` (PR → review)
182
-
> Picks the next **Review pool** PR, waits for Copilot review, fixes comments and CI failures, runs agentic feature tests, then moves it to **Final review** for human approval.
175
+
> Picks the next **Review pool** PR, runs agentic review (structural + quality + feature tests), then moves it to **Final review** for human approval.
0 commit comments