Skip to content

Add codex-harness-patterns plugin (14 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task, goal-persistence, model-router, completion-audit, fork-context-decision, subagent-family-tracking, goal-token-budgeting) - #18

Open
antianqi wants to merge 5 commits into
MiniMax-AI:mainfrom
antianqi:main

Conversation

@antianqi

@antianqi antianqi commented Aug 23, 2026

Copy link
Copy Markdown

What changes

Adds a new Skill-only Plugin at plugins/antianqi/codex-harness-patterns/.

This Plugin packages four long-running task patterns distilled from the OpenAI
Codex harness v0.149.0 execution model (Apache-2.0):

Skill Source pattern
tool-output-budget codex-rs/utils/output-truncation/ — token-aware head+tail+marker truncation of oversized tool output
context-pressure-compact codex-rs/core/src/compact.rs::run_pre_sampling_compact — structured snapshot before continuing a long task
parallel-fanout codex-rs/core/src/thread_manager.rs (FuturesUnordered) — dispatch 2+ independent sub-tasks with task and aggregate
plan-stream-emit protocol/src/protocol.rs (PlanUpdate / PlanDelta events) — emit a todowrite-shaped plan before non-trivial work

User value

After installing this Plugin, a MiniMax Code user can do any of:

"Read docs/internal-spec.md and summarize the data model — keep the full file off the main context"
"Refactor the auth subsystem across these 5 files. Plan first, then execute."
"Investigate why the test suite is flaky. Decompose into independent probes and run them in parallel."
"I'm at turn 35 of an open-source contribution. Compress the conversation so I can keep going."

Expected result: the agent picks the right Skill, follows the documented process, and
produces output that matches the Skill's output contract (each Skill ships with an example
section and a verification checklist).

Plugin submission checklist

  • Plugin lives at plugins/<github-owner>/<plugin-name> (plugins/antianqi/codex-harness-patterns).
  • plugin.json name matches the Plugin directory.
  • README.md includes a real example prompt and expected result.
  • LICENSE and plugin.json declare Apache-2.0.
  • Required executables, accounts, paid services, and supported platforms: none (Skill-only, no MCP server, no scripts, no native binaries).
  • Network destinations and data handled by the plugin: none (Skills are pure Markdown instructions; the agent applies them with its existing tools).
  • No credentials, private endpoints, hidden telemetry, installers, symlinks, or native binaries are included.
  • Every scaffold TODO has been replaced.
  • npm run check passes for this Plugin (OK plugin antianqi/codex-harness-patterns; the other FAIL lines in the validator output are from pre-existing community plugins with file-encoding issues and are unrelated to this PR).

Evidence

Local validation:

$ npm run validate
OK   example hello-mcode-mcp
OK   plugin antianqi/codex-harness-patterns

The four Skills were developed against the MiniMax Code Agent Plugins 1.0 contract
(docs/plugin-compatibility.md) and validated against the npm run check workflow.
They add no MCP server, no scripts, no network, no credentials, and
no native binaries. They are pure Markdown instructions that the agent applies
through its existing tool surface.

Inspiration

The patterns are inspired by the public Codex harness research at
https://github.com/openai/codex (Apache-2.0). Each Skill's frontmatter links to the
specific source file (inspired-by:) so reviewers can verify the mapping.


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

A Skill-only Plugin (no MCP, no network) packaging four long-running task
patterns distilled from OpenAI Codex harness v0.149.0 (codex-rs/core/).

Skills included:
  - tool-output-budget       truncate oversized tool output by token-aware
                             head + tail + marker (mirrors codex-rs/utils/
                             output-truncation)
  - context-pressure-compact structured snapshot before continuing a long
                             task (mirrors codex-rs/core/src/compact.rs)
  - parallel-fanout         dispatch 2+ independent sub-tasks with task()
                             and aggregate (mirrors FuturesUnordered in
                             codex-rs/core/src/thread_manager.rs)
  - plan-stream-emit        emit todowrite-shaped plan before non-trivial
                             work (mirrors PlanUpdate / PlanDelta events
                             in codex-rs/protocol/src/protocol.rs)

Validation: passes npm run check (OK plugin antianqi/codex-harness-patterns).
License: Apache-2.0 (matches the host repository).
…, world-state-tracking, background-task (4 new Skills, 8 total)

Adds four Skills that round out the long-running task toolkit:

  - review-mode              switch to critic mode after finishing a chunk,
                             produce a PASS / FIX / REDO verdict
                             (mirrors EnteredReviewMode/ExitedReviewMode)
  - delegate-with-context    write a minimal-context brief for task()
                             instead of forwarding the full history
                             (mirrors InterAgentCommunication / CollabAgentSpawn)
  - world-state-tracking     persist a structured state file that survives
                             context compaction (mirrors WorldState in
                             core/src/context/world_state.rs)
  - background-task          run long-running commands in the background
                             with a log file, poll on later turns
                             (mirrors unified_exec / CleanBackgroundTerminals)

Manifest bumped to 0.2.0; README and plugin.json keywords updated to
cover the full 8-Skill surface.

Validation: npm run check still passes for this plugin
(OK plugin antianqi/codex-harness-patterns).
@antianqi antianqi changed the title Add codex-harness-patterns plugin (4 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit) Add codex-harness-patterns plugin (8 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task) Aug 23, 2026
Adds two Skills that close the long-running task loop:

  - goal-persistence      P-14 SetThreadMemoryMode + ThreadGoalUpdated
                          (north-star goal file, drift self-test before
                          non-trivial tool calls, survives compactions)
  - model-router          P-07 model-provider-info + models-manager
                          (classify sub-task as cheap/medium/main, pass
                          model_config_id explicitly, no silent defaults)

Manifest bumped to 0.3.0; README table now lists all 10 Skills.

Validation: npm run check still passes for this plugin
(OK plugin antianqi/codex-harness-patterns).
antianqi added a commit to antianqi/codex-harness-patterns that referenced this pull request Aug 23, 2026
Adds two Skills that close the long-running task loop:

  - goal-persistence      P-14 (SetThreadMemoryMode + ThreadGoalUpdated)
                          North-star goal file, drift self-test before
                          non-trivial tool calls, survives compactions.

  - model-router          P-07 (model-provider-info + models-manager)
                          Classify each sub-task as cheap / medium / main
                          and pass model_config_id explicitly.

Total Skills: 10. Manifest bumped to 0.3.0.
Mirrors the v0.3.0 state of
MiniMax-AI/MiniMax-Code-Plugins::plugins/antianqi/codex-harness-patterns/.
Official PR: MiniMax-AI/MiniMax-Code-Plugins#18
License: Apache-2.0
@antianqi antianqi changed the title Add codex-harness-patterns plugin (8 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task) Add codex-harness-patterns plugin (10 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task, goal-persistence, model-router) Aug 23, 2026
…n; upgrade goal-persistence + parallel-fanout to v1.0

New Skills (2):

  - completion-audit         P-22 continuation template completion-audit section
                             (derive requirements, identify authoritative evidence,
                             verify each, only declare done on all-✅)

  - fork-context-decision   P-20 fork_turns semantics
                             (all / N / none — pick explicitly, not by default)

Skill upgrades to v1.0 (2):

  - goal-persistence        + completion-audit and blocked-audit sections
                            + token-budget reporting rule
                            + 'treat completion as unproven' alignment
  - parallel-fanout         + explicit-spawn principle (P-20: opt-in, not auto)
                            + max_concurrency awareness
                            + cross-references to fork-context-decision
                              and delegate-with-context
                            + completion-audit on aggregation before done

Total Skills: 12. Manifest bumped to 0.4.0.

Validation: npm run check still passes for this plugin
(OK plugin antianqi/codex-harness-patterns).
antianqi added a commit to antianqi/codex-harness-patterns that referenced this pull request Aug 23, 2026
…n; upgrade goal-persistence + parallel-fanout to v1.0

New Skills (2):
  - completion-audit        (P-22 continuation template completion-audit)
  - fork-context-decision  (P-20 fork_turns semantics)

Skill upgrades to v1.0 (2):
  - goal-persistence       (completion/blocked audit + token budget reporting)
  - parallel-fanout        (explicit-spawn + max_concurrency + cross-references)

Total Skills: 12. Manifest bumped to 0.4.0.
Mirrors v0.4.0 of MiniMax-AI/MiniMax-Code-Plugins::plugins/antianqi/codex-harness-patterns/.
Official PR: MiniMax-AI/MiniMax-Code-Plugins#18
License: Apache-2.0
@antianqi antianqi changed the title Add codex-harness-patterns plugin (10 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task, goal-persistence, model-router) Add codex-harness-patterns plugin (12 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task, goal-persistence, model-router, completion-audit, fork-context-decision) Aug 23, 2026
…ng; upgrade context-pressure-compact + delegate-with-context to v1.0

New Skills (2):
  - subagent-family-tracking  P-23 agent-graph-store + SessionSource::SubAgent
                              (parent/child tree, Open/Closed status, lost-child prevention)
  - goal-token-budgeting      P-22 ext/goal/src/accounting.rs + continuation template
                              (track token_budget, surface at 50/80/100%, stop at 100%)

Skill upgrades to v1.0 (2):
  - context-pressure-compact  + 64K retention budget (RETAINED_MESSAGE_TOKEN_BUDGET from P-10)
                              + discarded count reporting
                              + cross-references to all 5 persistent-state files
  - delegate-with-context     + V2 message envelope (Message Type / Task name / Sender / Payload)
                              + explicit return-path section
                              + cross-references to fork-context-decision / model-router /
                                subagent-family-tracking

Total Skills: 14. Manifest bumped to 0.5.0.

Validation: npm run check still passes for this plugin
(OK plugin antianqi/codex-harness-patterns).
antianqi added a commit to antianqi/codex-harness-patterns that referenced this pull request Aug 23, 2026
…ng; upgrade context-pressure-compact + delegate-with-context to v1.0

New Skills (2):
  - subagent-family-tracking  (P-23 — parent/child tree, Open/Closed status)
  - goal-token-budgeting      (P-22 — track token_budget, surface at 50/80/100%)

Skill upgrades to v1.0 (2):
  - context-pressure-compact  (P-10 64K retention budget + discarded count)
  - delegate-with-context     (P-20 V2 message envelope + return-path)

Total Skills: 14. Manifest bumped to 0.5.0.
Mirrors v0.5.0 of MiniMax-AI/MiniMax-Code-Plugins::plugins/antianqi/codex-harness-patterns/.
Official PR: MiniMax-AI/MiniMax-Code-Plugins#18
License: Apache-2.0
@antianqi antianqi changed the title Add codex-harness-patterns plugin (12 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task, goal-persistence, model-router, completion-audit, fork-context-decision) Add codex-harness-patterns plugin (14 Skills: tool-output-budget, context-pressure-compact, parallel-fanout, plan-stream-emit, review-mode, delegate-with-context, world-state-tracking, background-task, goal-persistence, model-router, completion-audit, fork-context-decision, subagent-family-tracking, goal-token-budgeting) Aug 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant