arcgentic
v2.0.0Moirai-derived gated engineering workflow for AI coding with verified Codex V2 orchestration.
by Arc StudioMIT2updated 2 months ago
Source
git clone https://github.com/Arch1eSUN/ArcgenticClone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.
Layout
├── .codex-plugin/plugin.json├── .claude-plugin/plugin.json├── skills/agency-roster/SKILL.md├── skills/arcgentic/SKILL.md├── skills/audit-round/SKILL.md├── skills/claude-code-session-broker/SKILL.md├── skills/close-round/SKILL.md├── skills/codex-thread-orchestration/SKILL.md├── skills/codify-lesson/SKILL.md├── skills/cross-session-handoff/SKILL.md├── skills/execute-round/SKILL.md├── skills/orchestrate-round/SKILL.md├── skills/plan-round/SKILL.md├── skills/pre-round-scan/SKILL.md├── skills/session-mode/SKILL.md├── skills/source-intake/SKILL.md├── skills/spec-governance/SKILL.md├── skills/track-refs/SKILL.md├── skills/using-arcgentic/SKILL.md└── skills/verify-gates/SKILL.md
Skills18
Use when a round references agency-agents catalogs, role-family routing, multi-agent identity prompts, or English/Chinese specialist role catalogs.
Use when the user says Arcgentic, asks to use Arcgentic, or wants an idea taken through a complete plan → development → self-audit → external audit workflow in Codex.
External-audit role for arcgentic rounds. Loaded when arcgentic state.yaml is in awaiting_audit or audit_in_progress, OR when the user explicitly requests an external audit of a finished round, OR when reviewing a handoff doc + commit chain against the round's declared scope. Produces a PASS / NEEDS_FIX / AUDIT_INCOMPLETE verdict document with mechanically-verifiable fact table, structured findings (P0-P3), and applies the lesson codification protocol. The output verdict file IS the handoff — do not paste verdict text into chat.
Use when running Arcgentic V2 in Claude Code and fixed Planner, Developer, and Auditor role sessions must be coordinated through a broker.
Use only after an arcgentic round has an external audit PASS and state.yaml is in passed. Anchors the verdict, runs strict audit-check, transitions passed to closed, and records the last passed round without writing an external audit verdict.
Use when running Arcgentic V2 in Codex and the current thread must orchestrate fixed Planner, Developer, Test, and Auditor role threads.
Detect recurring P2/P3 audit patterns across recent rounds and promote them into lesson cards. Use after round boundaries or when repeated findings appear.
Read, write, snapshot, and lock .arcgentic/state.yaml across planner, dev, audit, and optional test sessions.
Use when a planned round handoff exists and needs to be implemented end-to-end via the 4-commit chain (entry-admin → BA design → dev body with inline CR + SE → state refresh + self-audit). Dispatches ba-designer / developer / cr-reviewer / se-contract sequentially.
Main-session orchestrator for arcgentic rounds. Use when in single-session mode, when a project-level session mode must drive dispatch order, or when manually advancing the state machine. Dispatches role sub-agents, verifies structured outputs, and owns PASS-only close-round execution.
Use when starting a new round (substrate-touching / fix-round / admin) to generate a complete handoff doc from scope + prior-round context. Dispatches the planner sub-agent and validates output before writing.
Mandatory prelude for every role at the start of a round. Inventories available skills, MCP servers, plugins, sub-agents, and external references. Outputs which tools will be used in this round and which were considered but rejected, with reasons. Use as the very first action of every role skill in an arcgentic-managed project.
Use when a project has not yet stored session mode, when a user asks for complete arcgentic workflow execution, or when role identity handoff prompts are needed.
Use when a round cites external workflow sources, marketplace catalogs, OpenSpec resources, reference repos, or asks to fuse outside workflow material into arcgentic planning.
Use when a round uses proposal/design/tasks/spec/archive artifacts or needs OpenSpec-style artifact validation without depending on the OpenSpec CLI.
Maintain references/INDEX.md, classify reference RT tier, and emit BA-design triplet rows. Use when adding or refreshing reference projects.
Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or dispatch sub-agents. Use when starting any session in a project that has .agentic-rounds/state.yaml present, OR when the user mentions arcgentic / round-driven development / external audit / four-role workflow.
Runs the mechanical quality gates that the arcgentic state machine requires for state transitions. Invoked indirectly by transition.sh OR directly by orchestrator agent before declaring a state transition. Use when about to call transition.sh OR when manually verifying that a round artifact meets the gate criteria. Each gate is a single Bash script; output is PASS/FAIL with reason.
Manifests2
{
"name": "arcgentic",
"version": "2.0.0",
"description": "Moirai-derived gated engineering workflow for AI coding with verified Codex V2 orchestration.",
"author": {
"name": "Arc Studio"
},
"homepage": "https://github.com/Arch1eSUN/Arcgentic",
"repository": "https://github.com/Arch1eSUN/Arcgentic",
"license": "MIT",
"keywords": [
"agentic-harness",
"round-driven-development",
"external-audit",
"reference-first",
"lesson-codification"
],
"skills": "./skills/",
"interface": {
"displayName": "Arcgentic",
"shortDescription": "Turn AI coding into an orchestrated plan/dev/audit workflow.",
"longDescription": "Arcgentic packages Moirai-derived development discipline as reusable Codex skills backed by a Python CLI. Codex V2 is verified for automatic Orchestrator setup, role-thread dispatch, return handling, and gated closeout.",
"developerName": "Arc Studio",
"category": "Productivity",
"capabilities": [
"Round planning",
"Execution handoff",
"External audit",
"Reference tracking",
"Lesson codification",
"Cross-session handoff",
"Source intake",
"Spec governance",
"Project session mode",
"Verdict completeness",
"V2 Codex thread orchestration",
"Claude Code hook-backed broker",
"PASS-only close-round"
],
"defaultPrompt": "Use arcgentic to plan, execute, audit, or hand off a development round."
}
}{
"name": "arcgentic",
"description": "Agentic harness for rigorous round-driven development with external audit, closeout gates, and V2 fixed-role session orchestration.",
"version": "2.0.0",
"author": {
"name": "Arc Studio"
},
"homepage": "https://github.com/Arch1eSUN/Arcgentic",
"repository": "https://github.com/Arch1eSUN/Arcgentic",
"license": "MIT",
"keywords": [
"agentic-harness",
"round-driven-development",
"external-audit",
"reference-first",
"lesson-codification"
],
"skills": "./skills/",
"agents": [
"./agents/orchestrator.md",
"./agents/planner.md",
"./agents/developer.md",
"./agents/auditor.md",
"./agents/ref-tracker.md",
"./agents/lesson-codifier.md",
"./agents/ba-designer.md",
"./agents/cr-reviewer.md",
"./agents/se-contract.md"
]
}