Skip to content

Commit f023e71

Browse files
GiggleLiuclaude
andcommitted
docs: update contributing section in README
Simplify workflow description and link directly to issue templates. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 8a8316e commit f023e71

1 file changed

Lines changed: 9 additions & 12 deletions

File tree

README.md

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -48,18 +48,15 @@ assert_eq!(solution.iter().sum::<usize>(), 2); // Max IS size is 2
4848

4949
### Authorship Recognition
5050

51-
**Contribute 10 non-trivial reduction rules and you will be automatically added to the author list of the paper.** To facilitate the development, we provide the AI tools to help developers implement their *plans*. Developers still need to carefully design the test cases and verify the correctness of the reduction rules.
52-
53-
**Step by step**
54-
55-
1. Find or create a GitHub issue describing your proposal, which rule to add and how to test it. You may have some discussions with other developers to refine the proposal.
56-
2. Write a detailed plan in `docs/plans/issue-<number>-<slug>.md`.
57-
- If you use [Claude Code](https://github.com/anthropics/claude-code), it is recommended to use the [issue-to-pr](.claude/skills/issue-to-pr.md) skill. The skill will invoke [superpowers:brainstorm](https://github.com/obra/superpowers) to help you write a detailed plan:
58-
```
59-
/issue-to-pr <issue-number>
60-
```
61-
Afterwards, the skill creates a PR starting with `[action]`, which automatically triggers Claude CI to implement the plan.
62-
- Otherwise, you can write a detailed plan manually ([sample](docs/plans/2026-02-08-qubo-reductions-plan.md)). Then create a PR manually. You can start implementing this plan on the CI machine by adding `[action]` at the start of the PR description or comments.
51+
**Contribute 10 non-trivial reduction rules and you will be automatically added to the author list of the paper.** AI tools handle the implementation — contributors focus on designing correct reductions and test cases.
52+
53+
### How to Contribute
54+
55+
1. **Open an issue** using the [Problem](https://github.com/CodingThrust/problem-reductions/issues/new?template=problem.md) or [Rule](https://github.com/CodingThrust/problem-reductions/issues/new?template=rule.md) template. Fill in all sections — the templates guide you through the required information (definition, algorithm, size overhead, example instance, etc.).
56+
57+
2. **Create a PR from the issue.** Two options:
58+
- **With [Claude Code](https://github.com/anthropics/claude-code):** run `/issue-to-pr <issue-number>`. This verifies the issue is complete, researches the reference, writes an implementation plan, and creates a PR with `[action]` to trigger automated implementation.
59+
- **Manually:** write a plan in `docs/plans/` ([sample](docs/plans/2026-02-08-qubo-reductions-plan.md)), create a PR, and add `[action]` at the start of the PR description to trigger Claude CI.
6360

6461
### Developer Commands
6562

0 commit comments

Comments
 (0)