https://github.com/avidrucker/yegor-pm-skills
Eight Claude Code skills distilled from Yegor Bugayenko's XDSD methodology -- practical PM rules for solo devs and AI agents.
https://github.com/avidrucker/yegor-pm-skills
Last synced: about 2 months ago
JSON representation
Eight Claude Code skills distilled from Yegor Bugayenko's XDSD methodology -- practical PM rules for solo devs and AI agents.
- Host: GitHub
- URL: https://github.com/avidrucker/yegor-pm-skills
- Owner: avidrucker
- License: mit
- Created: 2026-05-23T19:56:31.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-23T23:07:56.000Z (2 months ago)
- Last Synced: 2026-05-24T01:12:10.240Z (2 months ago)
- Size: 104 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# yegor-pm-skills
Eleven versioned Claude Code skills distilled from Yegor Bugayenko's [XDSD](https://www.xdsd.org/) methodology — practical project-management rules a solo developer (and the AI agents helping them) can actually follow.
## What's inside
| Skill | One-liner |
|---|---|
| `yegor-pm` | Meta-orchestrator. Routes to the right sub-skill based on what you're doing. Daily driver. |
| `yegor-pdd` | **Puzzle Driven Development.** Every deferred sub-problem becomes a `@todo #N:Mm` comment at the code site. |
| `yegor-bdd` | **Bug Driven Development.** Every piece of work is a complaint with shape "have X / should have Y / repro." Reporter closes. |
| `yegor-microtasks` | Cap every task at ~60 minutes (default 30). Overrun → split into puzzles. |
| `yegor-tickets` | If it isn't in the issue tracker, it didn't happen. Write the comment before the chat reply. |
| `yegor-architect` | Separate architect mode (design in writing) from courier mode (execute agreed design). Never mix. |
| `yegor-velocity` | Velocity = closed tickets per week. Not commits, not hours, not LOC. |
| `yegor-nohelp` | Knowledge sharing through docs, not by tapping experts. `NOTES.md` is the minimum. |
| `yegor-spikes` | When scope/code-site is unknown, run a ≤60min research spike before writing a puzzle. |
| `yegor-review` | **Code review.** Reject, don't bless. Four NOs, 3 critical problems, never run the code. |
| `yegor-unit-tests` | **Test quality.** Tests must be able to fail. Anti-pattern catalog + fakes over mocks. |
Each skill ships `SKILL.md` + `VERSION` + `CHANGELOG.md` and can be bumped independently. The `research/` folder contains the deep-reference doc each skill is distilled from, citing Yegor's primary sources.
See [`GLOSSARY.md`](./GLOSSARY.md) for short definitions of the vocabulary these skills use — PDD, puzzle, spike, microtask, complaint, velocity, architect/courier, the Four NOs, and more.
## Install
Clone the repo, then symlink each skill into your Claude Code user-wide skills folder.
### Windows
```powershell
git clone git@github.com:avidrucker/yegor-pm-skills.git
$root = (Resolve-Path .\yegor-pm-skills).Path
foreach ($s in @("yegor-pm","yegor-pdd","yegor-bdd","yegor-microtasks","yegor-tickets","yegor-architect","yegor-velocity","yegor-nohelp","yegor-spikes","yegor-review","yegor-unit-tests")) {
cmd /c mklink /J "$env:USERPROFILE\.claude\skills\$s" "$root\skills\$s"
}
```
`mklink /J` creates a directory junction. No admin or Developer Mode required.
### macOS / Linux
```bash
git clone git@github.com:avidrucker/yegor-pm-skills.git
ROOT="$(pwd)/yegor-pm-skills"
mkdir -p "$HOME/.claude/skills"
for s in yegor-pm yegor-pdd yegor-bdd yegor-microtasks yegor-tickets yegor-architect yegor-velocity yegor-nohelp yegor-spikes yegor-review yegor-unit-tests; do
ln -s "$ROOT/skills/$s" "$HOME/.claude/skills/$s"
done
```
## Use
In any Claude Code session:
- `/yegor-pm` — meta orchestrator (the daily entry point)
- `/yegor-pdd`, `/yegor-bdd`, `/yegor-microtasks`, `/yegor-tickets`, `/yegor-architect`, `/yegor-velocity`, `/yegor-nohelp`, `/yegor-spikes`, `/yegor-review`, `/yegor-unit-tests` — individual rule sets
Each skill's `SKILL.md` is the action layer (triggers + rules). Each `research/philosophy_NN_*.md` is the context layer (sources + rationale). When in doubt, the SKILL.md links to its research doc.
## Bumping a skill
See [`project_setup_notes.md`](./project_setup_notes.md) §3 for the full workflow. Short version:
1. Edit `skills/yegor-/SKILL.md`.
2. Bump `VERSION` and the `version:` field in the SKILL.md frontmatter (keep them in sync).
3. Add a `## [X.Y.Z] — YYYY-MM-DD` section to `CHANGELOG.md`.
4. Commit: `git commit -m "yegor- X.Y.Z: "`.
Semver convention used here:
- **Patch** — typo/clarification, no behavior change.
- **Minor** — added rule, expanded guidance, refined trigger.
- **Major** — the principle itself changed.
For coordinated milestones across the whole stack: `git tag yegor-skills-vX.Y.Z`.
## Why these skills exist
Yegor Bugayenko's [XDSD methodology](https://www.xdsd.org/) was originally designed for distributed *teams*: pay-per-task, ticket-mediated communication, architect-led design, no meetings, no informal help channels. This repo adapts the philosophies for solo developers working with AI agents — the same disciplines, applied to a context where the "team" is you + Claude.
Background research is in [`research/zerocracy_2026_status_and_evolution.md`](./research/zerocracy_2026_status_and_evolution.md) and [`research/yegor_ideas_for_solo_dev_workflow.md`](./research/yegor_ideas_for_solo_dev_workflow.md).
## Talk transcript
The full SRT and plain-text transcript of Yegor's 2016 XDSD talk live on the `talks` branch:
```
git checkout talks
```
Kept off `main` so a default clone stays lean.
## Credits
All philosophies are distilled from [Yegor Bugayenko](https://www.yegor256.com/)'s writings on eXtremely Distributed Software Development, including:
- *Puzzle Driven Development* (2010, 2017)
- *Stop Chatting, Start Coding* (2014)
- *How XDSD Is Different* (2014)
- *Three Things I Expect From a Software Architect* (2015)
- *Five Principles of Bug Tracking* (2014)
- *Let the Bug Reporter Have the Last Word* (2025)
- *Stop Asking and Suggesting — Just Complain* / Bug Driven Development (2025)
- *Couriers, Not Coders* (2026)
- *Four NOs of a Serious Code Reviewer* (2015)
- *Does Code Review Involve Testing?* (2019)
- *You Do Need Independent Technical Reviews!* (2014)
- *Unit Testing Anti-Patterns, Full List* (2018)
- *Built-in Fake Objects* (2014)
- *Write Unit Tests, Don't Waste Our Money!* (2025)
Each `research/philosophy_NN_*.md` includes the full source list for its skill.
## License
MIT — see [LICENSE](./LICENSE).