{"id":50512980,"url":"https://github.com/avidrucker/yegor-pm-skills","last_synced_at":"2026-06-02T21:32:59.067Z","repository":{"id":359887068,"uuid":"1247802557","full_name":"avidrucker/yegor-pm-skills","owner":"avidrucker","description":"Eight Claude Code skills distilled from Yegor Bugayenko's XDSD methodology -- practical PM rules for solo devs and AI agents.","archived":false,"fork":false,"pushed_at":"2026-05-23T23:07:56.000Z","size":107,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T01:12:10.240Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/avidrucker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-23T19:56:31.000Z","updated_at":"2026-05-23T23:05:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/avidrucker/yegor-pm-skills","commit_stats":null,"previous_names":["avidrucker/yegor-pm-skills"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/avidrucker/yegor-pm-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidrucker%2Fyegor-pm-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidrucker%2Fyegor-pm-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidrucker%2Fyegor-pm-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidrucker%2Fyegor-pm-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avidrucker","download_url":"https://codeload.github.com/avidrucker/yegor-pm-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidrucker%2Fyegor-pm-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33838216,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-02T21:32:58.396Z","updated_at":"2026-06-02T21:32:59.062Z","avatar_url":"https://github.com/avidrucker.png","language":null,"funding_links":[],"categories":["Skill repos"],"sub_categories":[],"readme":"# yegor-pm-skills\n\nEleven 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.\n\n## What's inside\n\n| Skill | One-liner |\n|---|---|\n| `yegor-pm` | Meta-orchestrator. Routes to the right sub-skill based on what you're doing. Daily driver. |\n| `yegor-pdd` | **Puzzle Driven Development.** Every deferred sub-problem becomes a `@todo #N:Mm` comment at the code site. |\n| `yegor-bdd` | **Bug Driven Development.** Every piece of work is a complaint with shape \"have X / should have Y / repro.\" Reporter closes. |\n| `yegor-microtasks` | Cap every task at ~60 minutes (default 30). Overrun → split into puzzles. |\n| `yegor-tickets` | If it isn't in the issue tracker, it didn't happen. Write the comment before the chat reply. |\n| `yegor-architect` | Separate architect mode (design in writing) from courier mode (execute agreed design). Never mix. |\n| `yegor-velocity` | Velocity = closed tickets per week. Not commits, not hours, not LOC. |\n| `yegor-nohelp` | Knowledge sharing through docs, not by tapping experts. `NOTES.md` is the minimum. |\n| `yegor-spikes` | When scope/code-site is unknown, run a ≤60min research spike before writing a puzzle. |\n| `yegor-review` | **Code review.** Reject, don't bless. Four NOs, 3 critical problems, never run the code. |\n| `yegor-unit-tests` | **Test quality.** Tests must be able to fail. Anti-pattern catalog + fakes over mocks. |\n\nEach 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.\n\nSee [`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.\n\n## Install\n\nClone the repo, then symlink each skill into your Claude Code user-wide skills folder.\n\n### Windows\n\n```powershell\ngit clone git@github.com:avidrucker/yegor-pm-skills.git\n$root = (Resolve-Path .\\yegor-pm-skills).Path\nforeach ($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\")) {\n  cmd /c mklink /J \"$env:USERPROFILE\\.claude\\skills\\$s\" \"$root\\skills\\$s\"\n}\n```\n\n`mklink /J` creates a directory junction. No admin or Developer Mode required.\n\n### macOS / Linux\n\n```bash\ngit clone git@github.com:avidrucker/yegor-pm-skills.git\nROOT=\"$(pwd)/yegor-pm-skills\"\nmkdir -p \"$HOME/.claude/skills\"\nfor 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\n  ln -s \"$ROOT/skills/$s\" \"$HOME/.claude/skills/$s\"\ndone\n```\n\n## Use\n\nIn any Claude Code session:\n\n- `/yegor-pm` — meta orchestrator (the daily entry point)\n- `/yegor-pdd`, `/yegor-bdd`, `/yegor-microtasks`, `/yegor-tickets`, `/yegor-architect`, `/yegor-velocity`, `/yegor-nohelp`, `/yegor-spikes`, `/yegor-review`, `/yegor-unit-tests` — individual rule sets\n\nEach 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.\n\n## Bumping a skill\n\nSee [`project_setup_notes.md`](./project_setup_notes.md) §3 for the full workflow. Short version:\n\n1. Edit `skills/yegor-\u003cslug\u003e/SKILL.md`.\n2. Bump `VERSION` and the `version:` field in the SKILL.md frontmatter (keep them in sync).\n3. Add a `## [X.Y.Z] — YYYY-MM-DD` section to `CHANGELOG.md`.\n4. Commit: `git commit -m \"yegor-\u003cslug\u003e X.Y.Z: \u003cone-line reason\u003e\"`.\n\nSemver convention used here:\n- **Patch** — typo/clarification, no behavior change.\n- **Minor** — added rule, expanded guidance, refined trigger.\n- **Major** — the principle itself changed.\n\nFor coordinated milestones across the whole stack: `git tag yegor-skills-vX.Y.Z`.\n\n## Why these skills exist\n\nYegor 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.\n\nBackground 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).\n\n## Talk transcript\n\nThe full SRT and plain-text transcript of Yegor's 2016 XDSD talk live on the `talks` branch:\n\n```\ngit checkout talks\n```\n\nKept off `main` so a default clone stays lean.\n\n## Credits\n\nAll philosophies are distilled from [Yegor Bugayenko](https://www.yegor256.com/)'s writings on eXtremely Distributed Software Development, including:\n\n- *Puzzle Driven Development* (2010, 2017)\n- *Stop Chatting, Start Coding* (2014)\n- *How XDSD Is Different* (2014)\n- *Three Things I Expect From a Software Architect* (2015)\n- *Five Principles of Bug Tracking* (2014)\n- *Let the Bug Reporter Have the Last Word* (2025)\n- *Stop Asking and Suggesting — Just Complain* / Bug Driven Development (2025)\n- *Couriers, Not Coders* (2026)\n- *Four NOs of a Serious Code Reviewer* (2015)\n- *Does Code Review Involve Testing?* (2019)\n- *You Do Need Independent Technical Reviews!* (2014)\n- *Unit Testing Anti-Patterns, Full List* (2018)\n- *Built-in Fake Objects* (2014)\n- *Write Unit Tests, Don't Waste Our Money!* (2025)\n\nEach `research/philosophy_NN_*.md` includes the full source list for its skill.\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favidrucker%2Fyegor-pm-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favidrucker%2Fyegor-pm-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favidrucker%2Fyegor-pm-skills/lists"}