@sienklogic/plan-build-run 2.54.0 → 2.56.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to Plan-Build-Run will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.56.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.55.0...plan-build-run-v2.56.0) (2026-03-02)
+
+
+### Features
+
+* **58-02:** add Codex manual files (AGENTS.md, config.toml, README) ([c928ea6](https://github.com/SienkLogic/plan-build-run/commit/c928ea6d7170ce5c2b97bf5fe11505046f008396))
+
+
+### Bug Fixes
+
+* **58-02:** correct repo URL in codex-pbr README ([1b13b2a](https://github.com/SienkLogic/plan-build-run/commit/1b13b2a4799fa9827abf82feda4f87c2c65e2880))
+
+## [2.55.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.54.0...plan-build-run-v2.55.0) (2026-03-02)
+
+
+### Features
+
+* **57-01:** add CODEX_DIR constant and codex support in transformFrontmatter + transformAgentFrontmatter ([88652bc](https://github.com/SienkLogic/plan-build-run/commit/88652bc24f17bf2c7555d257f3e092b1d713eebe))
+* **57-01:** add generate/verify/main codex dispatch, export CODEX_DIR, and integration tests ([606f3fe](https://github.com/SienkLogic/plan-build-run/commit/606f3fee42c96f47300646021e79ea44706c704e))
+* **57-01:** extend transformBody with codex /pbr: transform and transformHooksJson null return ([baeabbb](https://github.com/SienkLogic/plan-build-run/commit/baeabbb4065808bb1ecb0961bd631c1443ae459d))
+* **57-02:** generate plugins/codex-pbr/ via generate-derivatives.js codex ([99d0d22](https://github.com/SienkLogic/plan-build-run/commit/99d0d220185c150bf7abd1d56806a36eea76be75))
+* **57-02:** GREEN - add hookFormat none guards and codex-pbr normalization in compat tests ([68812c3](https://github.com/SienkLogic/plan-build-run/commit/68812c34d71099b23c0b5cf320fa332215fb4f03))
+* **58-01:** finalize Jules AGENTS.md template with enforcement rules and workflows ([7c58ca3](https://github.com/SienkLogic/plan-build-run/commit/7c58ca38247402b58e51653faab831ce0c8d1d67))
+
 ## [2.54.0](https://github.com/SienkLogic/plan-build-run/compare/plan-build-run-v2.53.0...plan-build-run-v2.54.0) (2026-03-02)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sienklogic/plan-build-run",
-  "version": "2.54.0",
+  "version": "2.56.0",
   "description": "Plan it, Build it, Run it — structured development workflow for Claude Code",
   "keywords": [
     "claude-code",

package/plugins/codex-pbr/.codex/config.toml

@@ -0,0 +1,101 @@
+# PBR Workflow Configuration for Codex CLI
+# Copy this file to your project's .codex/config.toml and customize as needed.
+#
+# Each [profiles.*] section defines a named agent profile that can be selected
+# when Codex runs PBR skills. Uncomment and adjust the fields you want to change.
+#
+# Reference: https://github.com/openai/codex
+
+# ---------------------------------------------------------------------------
+# Sandbox Settings
+# ---------------------------------------------------------------------------
+# Controls which shell commands Codex is allowed to run during builds.
+# Adjust based on your project's build toolchain.
+
+[sandbox]
+# allow = ["bash", "git", "npm", "node", "python", "pip", "cargo", "make"]
+# deny  = ["curl", "wget", "ssh"]
+
+# ---------------------------------------------------------------------------
+# PBR Agent Profiles
+# ---------------------------------------------------------------------------
+# Each profile corresponds to a PBR agent role. Codex selects the appropriate
+# profile based on the active skill. You can override model and instructions
+# per role to tune cost/quality tradeoffs.
+
+# Research agent — explores domain, reads docs, summarizes findings.
+# Called by: $pbr-explore, $pbr-begin, $pbr-plan (research phase)
+[profiles.pbr-researcher]
+# description = "Research agent: investigates domain and summarizes findings"
+# model = "o4-mini"
+# instructions = "Focus on gathering factual information. Cite sources."
+
+# Planner agent — creates detailed, task-level phase plans.
+# Called by: $pbr-plan, $pbr-begin
+[profiles.pbr-planner]
+# description = "Planner agent: produces structured PLAN.md files"
+# model = "o3"
+# instructions = "Output valid PLAN.md frontmatter. Define must_haves precisely."
+
+# Executor agent — implements tasks from a PLAN.md, commits each task.
+# Called by: $pbr-build
+[profiles.pbr-executor]
+# description = "Executor agent: implements plan tasks with atomic commits"
+# model = "o4-mini"
+# instructions = "One task per commit. Follow the plan exactly. No scope creep."
+
+# Verifier agent — checks build output against plan must_haves.
+# Called by: $pbr-review
+[profiles.pbr-verifier]
+# description = "Verifier agent: produces VERIFICATION.md with evidence"
+# model = "o4-mini"
+# instructions = "Check evidence in the codebase. Do not assume correctness."
+
+# Integration checker agent — validates cross-component integration.
+# Called by: $pbr-health, $pbr-scan
+[profiles.pbr-integration-checker]
+# description = "Integration checker: validates cross-component contracts"
+# model = "o4-mini"
+# instructions = "Focus on interface boundaries and data flow between modules."
+
+# Debugger agent — hypothesis-driven bug investigation.
+# Called by: $pbr-debug
+[profiles.pbr-debugger]
+# description = "Debugger agent: systematic hypothesis-driven investigation"
+# model = "o3"
+# instructions = "Form falsifiable hypotheses. Test each before moving on."
+
+# Codebase mapper agent — creates ARCHITECTURE.md and related codebase docs.
+# Called by: $pbr-explore, $pbr-begin
+[profiles.pbr-mapper]
+# description = "Mapper agent: documents codebase structure and architecture"
+# model = "o4-mini"
+# instructions = "Be concise. Focus on structure over implementation details."
+
+# Synthesizer agent — aggregates research and produces structured summaries.
+# Called by: $pbr-explore, $pbr-discuss
+[profiles.pbr-synthesizer]
+# description = "Synthesizer agent: aggregates findings into structured output"
+# model = "o4-mini"
+# instructions = "Extract key insights. Surface tensions and open questions."
+
+# General agent — handles ad-hoc tasks and one-off instructions.
+# Called by: $pbr-do, $pbr-discuss
+[profiles.pbr-general]
+# description = "General agent: flexible agent for miscellaneous PBR tasks"
+# model = "o4-mini"
+# instructions = "Follow PBR workflow rules. Commit with correct format."
+
+# Audit agent — analyzes session logs for workflow compliance.
+# Called by: $pbr-audit
+[profiles.pbr-audit]
+# description = "Audit agent: reviews session logs and produces compliance reports"
+# model = "o4-mini"
+# instructions = "Be objective. Report findings without judgment."
+
+# Dev-sync agent — synchronizes changes across plugin derivatives.
+# Called internally — not a user-facing skill.
+[profiles.pbr-dev-sync]
+# description = "Dev-sync agent: propagates pbr/ changes to cursor-pbr/ and codex-pbr/"
+# model = "o4-mini"
+# instructions = "Apply diffs exactly. Do not add scope beyond the sync target."