{"id":50574777,"url":"https://github.com/setrathexx/codex-engineering-workflow-pack","last_synced_at":"2026-06-07T23:01:14.083Z","repository":{"id":360409996,"uuid":"1248637562","full_name":"SetraTheXX/Codex-Engineering-Workflow-Pack","owner":"SetraTheXX","description":"Local-first engineering workflow toolkit for Codex: skills, Coordinator Mode, worktree isolation, guarded dispatch, and parallel agent workflows.","archived":false,"fork":false,"pushed_at":"2026-05-31T17:09:27.000Z","size":308,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-04T21:04:36.476Z","etag":null,"topics":["agentic-workflow","ai-coding","codex","codex-cli","codex-skills","developer-tool","local-first","multi-agent","tdd","workflow"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@setrathex/codex-engineering-workflow-pack","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/SetraTheXX.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":"docs/security-model.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-05-24T22:35:49.000Z","updated_at":"2026-05-31T17:08:04.000Z","dependencies_parsed_at":"2026-06-07T23:00:40.813Z","dependency_job_id":null,"html_url":"https://github.com/SetraTheXX/Codex-Engineering-Workflow-Pack","commit_stats":null,"previous_names":["setrathexx/codex-engineering-workflow-pack"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/SetraTheXX/Codex-Engineering-Workflow-Pack","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SetraTheXX%2FCodex-Engineering-Workflow-Pack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SetraTheXX%2FCodex-Engineering-Workflow-Pack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SetraTheXX%2FCodex-Engineering-Workflow-Pack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SetraTheXX%2FCodex-Engineering-Workflow-Pack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SetraTheXX","download_url":"https://codeload.github.com/SetraTheXX/Codex-Engineering-Workflow-Pack/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SetraTheXX%2FCodex-Engineering-Workflow-Pack/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34041089,"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-07T02:00:07.652Z","response_time":124,"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":["agentic-workflow","ai-coding","codex","codex-cli","codex-skills","developer-tool","local-first","multi-agent","tdd","workflow"],"created_at":"2026-06-04T21:01:17.674Z","updated_at":"2026-06-07T23:01:14.078Z","avatar_url":"https://github.com/SetraTheXX.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Codex Engineering Workflow Pack\n\n[![npm version](https://img.shields.io/npm/v/@setrathex/codex-engineering-workflow-pack?tag=latest)](https://www.npmjs.com/package/@setrathex/codex-engineering-workflow-pack)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\nLocal-first engineering workflow toolkit for Codex: skills, PRDs, issues, TDD, diagnostics, handoffs, and multi-agent Coordinator Mode.\n\nCEWP is an unofficial local-first pack for structured engineering work in Codex. It installs reusable repo or global skills, and it provides a local runtime for coordinating Manager, Worker, and Reviewer Codex sessions through files under `.cewp/`. Coordinator Mode supports worktree isolation, guarded `codex-exec` dispatch, sequential or parallel workers, review packets, reviewer decisions, and operator policy modes.\n\n## Highlights\n\n- 10 engineering workflow skills for setup, diagnosis, TDD, PRDs, issue slicing, handoff, prototyping, architecture review, and context mapping.\n- Repo-scoped or global installation.\n- Local Coordinator Mode runtime under `.cewp/runs/\u003crun-id\u003e/`.\n- Worktree helpers for isolated worker branches.\n- Dispatch planning, readiness checks, prompt bundles, and dry-run previews.\n- Guarded `codex-exec` execution for workers and reviewers.\n- Sequential and parallel worker execution with scope checks.\n- Reviewer gate with `Decision: PASS | REQUEST_CHANGES | BLOCK`.\n- Operator policy modes: `safe`, `trusted`, and `full-authority`.\n- Deterministic harness smoke tests for release prep.\n\n## Quick Start\n\nRun once in a repo:\n\n```bash\nnpx @setrathex/codex-engineering-workflow-pack init\n```\n\nOr install globally:\n\n```bash\nnpm install -g @setrathex/codex-engineering-workflow-pack\ncewp init\n```\n\nCheck the install:\n\n```bash\ncewp doctor\ncewp list\n```\n\nStart a local Coordinator Mode run:\n\n```bash\ncewp run init --workers 2 --reviewer\ncewp run worktrees create --dry-run\ncewp run dispatch pipeline --adapter codex-exec --dry-run\n```\n\nAsk Codex naturally:\n\n```txt\nUse CEWP Coordinator Mode to implement this docs-only change with two workers and a reviewer. Show me the plan before dispatch.\n```\n\n## Coordinator Mode\n\nCoordinator Mode is CEWP's local runtime for multi-agent engineering work. A Manager plans and splits tasks, Workers implement in isolated worktrees, a Reviewer verifies the result, and the user decides whether to finalize, merge, push, publish, or release.\n\nTypical flow:\n\n```bash\ncewp run init --workers 2 --reviewer\ncewp run worktrees create --run \u003crun-id\u003e\ncewp run dispatch pipeline --run \u003crun-id\u003e --adapter codex-exec --dry-run\ncewp run dispatch pipeline --run \u003crun-id\u003e --adapter codex-exec --yes --parallel --timeout 120\ncewp run finalize --run \u003crun-id\u003e --dry-run\ncewp run finalize --run \u003crun-id\u003e\ncewp run cleanup --run \u003crun-id\u003e\n```\n\nSee [Coordinator Mode](docs/coordinator-mode.md).\n\n## Operator Policy\n\nCEWP can store a local operator policy in `.cewp/policy.json` so Codex can understand how much autonomy the user allows in a repo.\n\n```bash\ncewp policy show\ncewp policy set safe\ncewp policy set trusted\ncewp policy set full-authority\ncewp policy reset\n```\n\n`safe` is the default. `full-authority` is a supported advanced mode for experienced users, but it does not disable CEWP guardrails. Push, publish, and release remain disabled by default unless explicitly allowed by policy later.\n\nThe CLI enforces policy for actual high-impact local actions such as worker execution, reviewer execution, pipeline execution, finalize, cleanup, and prune deletion. Dry-run and read-only commands remain available in every mode.\n\nSee [Operator Policy](docs/operator-policy.md).\n\n## Safety Model\n\nCEWP is local-first and approval-gated. It does not automatically merge, push, publish, or create releases. Worker scope checks include both working tree changes and committed branch changes since the registered `baseCommit`. Cleanup and prune are dry-run by default.\n\nSee [Security Model](docs/security-model.md).\n\n## Documentation\n\n- [Install Guide](docs/install.md)\n- [Coordinator Mode](docs/coordinator-mode.md)\n- [Adapter Contract](docs/adapter-contract.md)\n- [Operator Policy](docs/operator-policy.md)\n- [Security Model](docs/security-model.md)\n- [Release Notes](docs/release-notes.md)\n\n## Harness Smoke\n\nFor release prep:\n\n```bash\nnode tests/harness/run-smoke.js\n```\n\nThe harness uses temporary repos, checks Coordinator Mode helpers, and does not run `codex exec`, publish, push, merge, or change package version.\n\n## Status\n\n`0.2.0-beta.2` is beta software. Use it for local-first workflow automation and dogfooding, and keep reviewing generated plans, worker output, and reviewer decisions before integrating changes.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsetrathexx%2Fcodex-engineering-workflow-pack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsetrathexx%2Fcodex-engineering-workflow-pack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsetrathexx%2Fcodex-engineering-workflow-pack/lists"}