{"id":50789582,"url":"https://github.com/23min/ai-workflow-rituals","last_synced_at":"2026-06-12T10:01:46.544Z","repository":{"id":356705302,"uuid":"1223778264","full_name":"23min/ai-workflow-rituals","owner":"23min","description":"Companion to ai-workflow with Claude Code agents and skills","archived":false,"fork":false,"pushed_at":"2026-05-29T13:07:46.000Z","size":120,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T15:06:36.861Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/23min.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-04-28T16:39:41.000Z","updated_at":"2026-05-29T13:07:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/23min/ai-workflow-rituals","commit_stats":null,"previous_names":["23min/ai-workflow-rituals"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/23min/ai-workflow-rituals","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/23min%2Fai-workflow-rituals","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/23min%2Fai-workflow-rituals/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/23min%2Fai-workflow-rituals/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/23min%2Fai-workflow-rituals/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/23min","download_url":"https://codeload.github.com/23min/ai-workflow-rituals/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/23min%2Fai-workflow-rituals/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34238714,"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-12T02:00:06.859Z","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-12T10:01:45.591Z","updated_at":"2026-06-12T10:01:46.525Z","avatar_url":"https://github.com/23min.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ai-workflow-rituals\n\nA Claude Code plugin marketplace shipping engineering-ritual skills and role agents that complement [`aiwf`](https://github.com/23min/ai-workflow-v2).\n\n\u003e Pre-alpha. Marketplace and plugin manifests scaffolded; no skills shipped yet.\n\n## What this is\n\n`aiwf` is a narrow planning kernel: six entity kinds (epic, milestone, ADR, gap, decision, contract), stable IDs, validators, git-trailer history. It deliberately has no opinion about how the work *gets done* — branching, TDD, code review, milestone lifecycle, release ceremonies.\n\nThis repo ships those opinions, separately, as Claude Code plugins. Two plugins, both optional:\n\n| Plugin | Contains | When to install |\n|---|---|---|\n| **aiwf-extensions** | Milestone-lifecycle skills (`aiwfx-start-milestone`, `aiwfx-wrap-milestone`, `aiwfx-wrap-epic`, `aiwfx-release`, `aiwfx-record-decision`, …) plus four role agents (planner, builder, reviewer, deployer) | If you use `aiwf` as your planning kernel and want the milestone-driven engineering loop |\n| **wf-rituals** | Generic engineering rituals (`wf-patch`, `wf-tdd-cycle`, `wf-review-code`, `wf-doc-lint`) | If you want the engineering rituals on their own — works on any repo, with or without `aiwf` |\n\n## Install\n\nIn a Claude Code session, from inside a consumer repo:\n\n```\n/plugin marketplace add 23min/ai-workflow-rituals\n/plugin install aiwf-extensions@ai-workflow-rituals\n/plugin install wf-rituals@ai-workflow-rituals    # optional\n```\n\nUpdates: `/plugin update \u003cname\u003e@ai-workflow-rituals`. Auto-update on startup is enabled by default while the marketplace is in active development.\n\n### Choosing an install scope\n\nClaude Code asks where to install. Pick **Project** scope by default. It writes `.claude/settings.json` into the consumer repo, which means:\n\n- Collaborators who clone the repo get the same plugins automatically.\n- Your other projects (using v1, a different framework, or none at all) stay clean.\n- The team's choice of rituals is reproducible and reviewable in PRs.\n\n**User scope** is only right if you're sure you want these plugins available in *every* project on your machine. **Local scope** (gitignored) is right for short-term experimentation in a single repo.\n\nFor the planning kernel itself, see [`ai-workflow-v2`](https://github.com/23min/ai-workflow-v2):\n\n```bash\ngo install github.com/23min/ai-workflow-v2/tools/cmd/aiwf@latest\naiwf init                # in your consumer repo\n```\n\n## Coupling boundary\n\nThe two plugins differ in how tightly they couple to `aiwf`. This is deliberate.\n\n- **`aiwfx-*` skills** — call `aiwf` shell verbs, reference `aiwf`'s ID format (`E-NN`, `M-NNN`, …), use `aiwf`'s status vocabulary. By definition coupled. If you don't use `aiwf`, this plugin is dead weight.\n- **`wf-*` skills** — speak the language of the work (milestone, acceptance criteria, branch, test, PR) without mentioning `aiwf`, its IDs, its status vocabulary, or its directory layout. By design they survive an `aiwf` swap. They work the same against a repo using `aiwf`, against a repo using a different planning kernel, or against a repo using none.\n\nThis is a discipline, not an enforcement. Every `wf-*` skill goes through a coupling-boundary review at port time: *\"if `aiwf` were deleted tomorrow, would this skill still make sense?\"* If no, it belongs in `aiwfx-*`.\n\n## Repository layout\n\n```\nai-workflow-rituals/\n├── .claude-plugin/\n│   └── marketplace.json\n├── plugins/\n│   ├── aiwf-extensions/\n│   │   ├── .claude-plugin/plugin.json\n│   │   ├── skills/aiwfx-*/SKILL.md\n│   │   ├── agents/{planner,builder,reviewer,deployer}.md\n│   │   └── templates/\n│   └── wf-rituals/\n│       ├── .claude-plugin/plugin.json\n│       ├── skills/wf-*/SKILL.md\n│       └── templates/\n├── README.md\n└── CHANGELOG.md\n```\n\nEach plugin's directory layout follows Claude Code's plugin reference. Contents are auto-discovered.\n\n## Status\n\n| Plugin | Stage |\n|---|---|\n| Marketplace manifest | scaffolded |\n| `aiwf-extensions` plugin manifest | scaffolded |\n| `wf-rituals` plugin manifest | scaffolded |\n| `aiwf-extensions` skills | not started |\n| `aiwf-extensions` agents | not started |\n| `aiwf-extensions` templates | not started |\n| `wf-rituals` skills | not started |\n| `wf-rituals` templates | not started |\n\nThe porting plan and the rationale for what's in scope vs. deferred lives in [`ai-workflow-v2/docs/rituals-plugin-plan.md`](https://github.com/23min/ai-workflow-v2/blob/poc/aiwf-v3/docs/rituals-plugin-plan.md).\n\n## License\n\nApache-2.0. See [`LICENSE`](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F23min%2Fai-workflow-rituals","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F23min%2Fai-workflow-rituals","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F23min%2Fai-workflow-rituals/lists"}