{"id":49058252,"url":"https://github.com/sefaertunc/worclaude","last_synced_at":"2026-04-24T00:01:18.758Z","repository":{"id":346460365,"uuid":"1189715047","full_name":"sefaertunc/Worclaude","owner":"sefaertunc","description":"CLI scaffolding tool that generates tailored .claude/ workflow infrastructure for Claude Code projects","archived":false,"fork":false,"pushed_at":"2026-04-18T17:59:28.000Z","size":3499,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T18:14:55.406Z","etag":null,"topics":["ai","ai-agent","ai-agents","ai-tools","automation","claude","claude-ai","claude-code","claude-code-skill","claude-skills","cli","developer-tools","workflow"],"latest_commit_sha":null,"homepage":"https://sefaertunc.github.io/Worclaude/","language":"JavaScript","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/sefaertunc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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-03-23T15:42:38.000Z","updated_at":"2026-04-18T17:59:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"e4fd168f-50bb-4442-a246-0648b94ee943","html_url":"https://github.com/sefaertunc/Worclaude","commit_stats":null,"previous_names":["sefaertunc/claude-workflow","sefaertunc/worclaude"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/sefaertunc/Worclaude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sefaertunc%2FWorclaude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sefaertunc%2FWorclaude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sefaertunc%2FWorclaude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sefaertunc%2FWorclaude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sefaertunc","download_url":"https://codeload.github.com/sefaertunc/Worclaude/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sefaertunc%2FWorclaude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32203362,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T20:19:26.138Z","status":"ssl_error","status_checked_at":"2026-04-23T20:19:23.520Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai","ai-agent","ai-agents","ai-tools","automation","claude","claude-ai","claude-code","claude-code-skill","claude-skills","cli","developer-tools","workflow"],"created_at":"2026-04-20T00:14:36.765Z","updated_at":"2026-04-24T00:01:18.744Z","avatar_url":"https://github.com/sefaertunc.png","language":"JavaScript","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/worclaude.png\" alt=\"Worclaude — The Workflow Layer for Claude Code\" width=\"100%\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/worclaude\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/worclaude\" alt=\"npm version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/worclaude\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/worclaude\" alt=\"downloads\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sefaertunc/Worclaude/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/sefaertunc/Worclaude/ci.yml?label=tests\" alt=\"tests\" /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/sefaertunc/Worclaude\" alt=\"license\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/node-%3E%3D18-brightgreen\" alt=\"node \u003e= 18\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/built%20for-Claude%20Code-cc785c\" alt=\"Built for Claude Code\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/sponsors/sefaertunc\"\u003e\u003cimg src=\"https://img.shields.io/badge/GitHub%20Sponsors-support-ea4aaa?logo=githubsponsors\u0026style=for-the-badge\" alt=\"GitHub Sponsors\" height=\"40\" /\u003e\u003c/a\u003e\n  \u0026nbsp;\n  \u003ca href=\"https://buymeacoffee.com/sefaertunc\"\u003e\u003cimg src=\"https://img.shields.io/badge/Buy%20Me%20a%20Coffee-support-yellow?logo=buymeacoffee\u0026style=for-the-badge\" alt=\"Buy Me a Coffee\" height=\"40\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://sefaertunc.github.io/Worclaude/\"\u003eDocumentation\u003c/a\u003e ·\n  \u003ca href=\"https://www.npmjs.com/package/worclaude\"\u003enpm\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/sefaertunc/Worclaude/issues\"\u003eIssues\u003c/a\u003e\n\u003c/p\u003e\n\n# Worclaude — The Workflow Layer for Claude Code\n\nWorclaude scaffolds a complete Claude Code workflow into any project in seconds. One `init` command installs 26 agents, 18 slash commands, 16 skills, 8 lifecycle hooks, a two-store memory system, and a CLAUDE.md template tuned for your tech stack. It implements the patterns in [howborisusesclaudecode.com](https://www.howborisusesclaudecode.com/) as a reusable, upgradable scaffold, so you stop rebuilding the same configuration for every new project.\n\n\u003cdiv align=\"center\"\u003e\n\n| CLI Commands |          Agents           | Slash Commands |        Skills         |      Hooks       |  Tech Stacks  |\n| :----------: | :-----------------------: | :------------: | :-------------------: | :--------------: | :-----------: |\n|      8       | 6 universal + 20 optional |       18       |          16           |     8 events     |      16       |\n| subcommands  |    across 6 categories    | session tools  | universal + templates | lifecycle events | auto-detected |\n\n\u003c/div\u003e\n\n---\n\n## What You Get\n\n`worclaude init` installs a production-ready Claude Code workflow:\n\n### Agents (26 total)\n\n- **6 universal:** plan-reviewer (Opus), code-simplifier (Sonnet, worktree), test-writer (Sonnet, worktree), build-validator (Haiku), verify-app (Sonnet, worktree), upstream-watcher (Sonnet)\n- **20 optional** across 6 categories — Backend, Frontend, DevOps, Quality, Documentation, Data/AI. Worclaude recommends agents based on your project type.\n\n### Slash Commands (18)\n\nSession lifecycle, review, verification, memory, upstream awareness, and git automation:\n\n`/start` `/end` `/commit-push-pr` `/review-plan` `/techdebt` `/verify` `/compact-safe` `/status` `/update-claude-md` `/learn` `/setup` `/sync` `/conflict-resolver` `/review-changes` `/build-fix` `/refactor-clean` `/test-coverage` `/upstream-check`\n\n### Skills (16)\n\n- **12 universal** — context-management, git-conventions, planning-with-files, review-and-handoff, prompt-engineering, verification, testing, claude-md-maintenance, coding-principles, subagent-usage, security-checklist, coordinator-mode\n- **3 project templates** filled in automatically by `/setup` — backend-conventions, frontend-design-system, project-patterns\n- **1 generated** — agent-routing, dynamically built from your agent selections\n\nSkills use Claude Code's directory format (`skill-name/SKILL.md`) and support **conditional activation** via path globs, so Claude only carries knowledge relevant to the current file.\n\n### Hooks (8 lifecycle events)\n\nWorclaude scaffolds hooks across the full Claude Code lifecycle:\n\n- **SessionStart** — auto-loads CLAUDE.md, PROGRESS.md, last session summary, and recent learnings\n- **PostToolUse** — auto-formats code after every edit, using the right formatter for your stack\n- **PostCompact** — re-reads key files after context compaction so Claude stays oriented\n- **PreCompact** — emergency git snapshot before auto-compaction\n- **UserPromptSubmit** — detects correction signals and suggests skills based on prompt content\n- **Stop** — extracts `[LEARN]` blocks from the transcript and persists them to disk\n- **SessionEnd / Notification** — quiet-by-default session-end and desktop alerts\n\nThree profiles via `WORCLAUDE_HOOK_PROFILE`: `minimal` (context hooks only), `standard` (all hooks, default), `strict` (standard + TypeScript checking on every edit).\n\n### Learnings System\n\nA personal, gitignored store at `.claude/learnings/` captures corrections and rules Claude picks up mid-session and replays them at the start of future sessions. The `correction-detect.cjs` and `learn-capture.cjs` hooks do this automatically; the `/learn` slash command is the explicit capture path. Unlike CLAUDE.md (shared rules, in git), learnings are yours — useful for personal conventions that should not leak into the repo. Promote a learning to CLAUDE.md when it matures into something every contributor should follow.\n\n### Cross-Tool Compatibility\n\n`AGENTS.md` is scaffolded alongside `CLAUDE.md` as a single source of truth for Cursor, Codex, GitHub Copilot, and other AI coding tools that expect `AGENTS.md`. Switching tools does not require maintaining parallel rule files.\n\n### Doctor\n\n`worclaude doctor` runs a four-category health check: core files (workflow-meta, CLAUDE.md, settings.json), components (agents, commands, skills, agent-routing), documentation (PROGRESS.md, SPEC.md), and integrity (file hashes, hook-event validity, deprecated models, CLAUDE.md line budget, learnings index integrity, gitignore coverage). Every check reports PASS/WARN/FAIL with actionable diagnostics.\n\n### Configuration\n\nPre-configured permissions per tech stack (Node.js, Python, Go, Rust, and 12 more), a CLAUDE.md template with progressive disclosure via skills, sandbox / effort / output defaults out of the box.\n\n---\n\n## Quick Start\n\n```bash\nnpx worclaude init\n```\n\nOr install globally:\n\n```bash\nnpm install -g worclaude\ncd your-project\nworclaude init\n```\n\nFollow the interactive prompts to select your project type, tech stack, and agents. Then open Claude Code and run `/setup` to fill in your project-specific content.\n\nFor parallel tasks, launch Claude with worktrees:\n\n```bash\nclaude --worktree --tmux\n```\n\n---\n\n## Commands\n\n| Command             | Description                                                 |\n| ------------------- | ----------------------------------------------------------- |\n| `worclaude init`    | Scaffold workflow into new or existing project              |\n| `worclaude upgrade` | Update universal components and repair on-disk drift        |\n| `worclaude status`  | Show current workflow state, version, and npm update status |\n| `worclaude backup`  | Create a timestamped backup of workflow files               |\n| `worclaude restore` | Restore from a previous backup                              |\n| `worclaude diff`    | Compare current setup vs latest template                    |\n| `worclaude delete`  | Remove worclaude workflow from project                      |\n| `worclaude doctor`  | Validate workflow installation health                       |\n\nThe `init` command detects existing setups and merges intelligently — no data is overwritten without your confirmation. Use `upgrade` to pull in new features, restore missing files, and preserve your customizations. `upgrade` accepts `--dry-run`, `--yes`, and `--repair-only` for scripted flows.\n\nSee the [full command reference](https://sefaertunc.github.io/Worclaude/reference/commands) for detailed usage and options.\n\n---\n\n## Why Worclaude\n\n- **Split architecture.** CLAUDE.md stays under 200 lines for speed; detail lives in skills loaded on demand. Personal rules live in `.claude/learnings/` (gitignored); shared rules live in CLAUDE.md.\n- **Learning loop.** Correct Claude once, it captures the rule, the next session picks it up at start — no re-stating.\n- **Cross-tool ready.** `AGENTS.md` generated from the same source as CLAUDE.md, so your rules work in Cursor / Codex / Copilot too.\n- **Hook profiles.** Dial strictness up or down via one environment variable. `minimal` for CI, `standard` for daily work, `strict` for type-heavy projects.\n- **Smart merge.** Detects existing Claude Code setups and merges additively — existing files never overwritten without confirmation. Three-tier strategy: additive for missing content, safe-alongside for conflicts, interactive for CLAUDE.md.\n- **Self-healing doctor.** Catches drift, stale hashes, deprecated models, broken learnings — before they bite.\n- **Batched releases.** Every PR declares `Version bump: {major|minor|patch|none}` in its body; `/sync` aggregates declarations across merged PRs and only cuts a release when at least one rises above `none`. Internal-only work (docs, CI, tests) accumulates on `develop` without triggering noisy publishes.\n\n---\n\n## Acknowledgments\n\nWorclaude draws from patterns and insights across the Claude Code ecosystem:\n\n- [Boris Cherny's Claude Code tips](https://howborisusesclaudecode.com/) — The foundational workflow patterns: multi-terminal pipelines, plan-then-execute, CLAUDE.md as shared knowledge, verification-first development\n- [everything-claude-code](https://github.com/affaan-m/everything-claude-code) by Affaan Mir (Anthropic hackathon winner) — Session persistence, hook profiles, confidence filtering, security scanning patterns\n- [Andrej Karpathy's coding principles](https://github.com/multica-ai/andrej-karpathy-skills) — Think before coding, simplicity first, surgical changes ([original post](https://x.com/karpathy/status/2015883857489522876))\n- [pro-workflow](https://github.com/peterHoburg/pro-workflow) — Correction detection, learning capture hooks, loop prevention patterns\n- [Anthropic Engineering Blog](https://www.anthropic.com/engineering) — Agent design, context engineering, harness patterns\n- [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code) by hesreallyhim — Community resource discovery and ecosystem awareness\n- [awesome-claude-code-toolkit](https://github.com/rohitg00/awesome-claude-code-toolkit) by rohitg00 — Toolkit patterns and companion app references\n- [claude-skills-cli](https://github.com/anthropics/skills) — Skill activation patterns and conditional loading insights\n- [SuperClaude](https://github.com/andyholst/SuperClaude) — Persona and mode system analysis (informed what NOT to build)\n- [ccusage](https://github.com/yashikota/ccusage) / [claude-devtools](https://github.com/nicobailey/claude-devtools) — Observability patterns (informed what NOT to build)\n- [claude-flow](https://github.com/Ruflo/claude-flow) by Ruflo — Runtime orchestration patterns (informed the scaffolding-only philosophy)\n- [Vercel SkillKit](https://github.com/vercel/skillkit) — Skill packaging and marketplace patterns\n- [claude-code-templates](https://github.com/danielsalas/claude-code-templates) by Daniel Avila — Template gallery and component catalog reference\n\n---\n\n## Links\n\n- [Full Documentation](https://sefaertunc.github.io/Worclaude/) — VitePress site with guides and reference\n- [npm Package](https://www.npmjs.com/package/worclaude)\n- [GitHub Issues](https://github.com/sefaertunc/Worclaude/issues)\n- [Contributing](CONTRIBUTING.md)\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [Security Policy](SECURITY.md)\n- [License: MIT](LICENSE)\n\n---\n\nBuilt on [Boris Cherny's Claude Code tips](https://www.howborisusesclaudecode.com/). MIT licensed.\n","funding_links":["https://github.com/sponsors/sefaertunc","https://buymeacoffee.com/sefaertunc"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsefaertunc%2Fworclaude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsefaertunc%2Fworclaude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsefaertunc%2Fworclaude/lists"}