Skip to content

[codex] Add capability map to gen-plan#151

Open
zevorn wants to merge 3 commits intoPolyArch:devfrom
zevorn:codex/feature-capability-map
Open

[codex] Add capability map to gen-plan#151
zevorn wants to merge 3 commits intoPolyArch:devfrom
zevorn:codex/feature-capability-map

Conversation

@zevorn
Copy link
Copy Markdown
Contributor

@zevorn zevorn commented May 9, 2026

Background

This change is inspired by the paper EvoDev: An Iterative Feature-Driven Framework for End-to-End Software Development with LLM-based Agents. EvoDev uses a Feature Map to model feature dependencies and propagate business, design, and implementation context across iterations.

This PR does not adopt EvoDev wholesale. It applies the same planning insight to Humanize's gen-plan: every implementation task should know where it sits in the global capability/feature structure. The new map gives tasks a shared frame of reference before they are broken down into executable coding / analyze items.

After adding the map to plan generation, this also wires that context into RLCR execution so Claude coding prompts, Codex reviews, round contracts, and the Goal Tracker can keep work anchored to the relevant capability node instead of losing the global position during later rounds.

Summary

  • add a Feature Map / Capability Map section to the gen-plan output template
  • require gen-plan to preserve capability-level business/design/implementation context before Task Breakdown
  • document refine-plan preservation behavior for the optional capability map section
  • add RLCR Capability Anchor guidance to round-0 setup, follow-up prompts, drift recovery, and review phase prompts
  • add a Capability column to Goal Tracker Active Tasks generated by RLCR setup
  • add Codex Capability Map Alignment Check sections to regular and full alignment review templates
  • update the Claude-facing Humanize command/skill docs so the plugin exposes the new capability-anchor behavior
  • document capability maps and RLCR capability anchors in README and the Claude usage guide
  • keep Claude plugin metadata and version unchanged at 1.17.0
  • add structure tests for the new planning and RLCR execution contracts

Validation

  • jq empty .claude-plugin/plugin.json .claude-plugin/marketplace.json
  • bash tests/test-task-tag-routing.sh
  • bash tests/test-template-references.sh
  • bash tests/test-templates-comprehensive.sh
  • bash tests/robustness/test-setup-scripts-robustness.sh
  • bash tests/test-plan-file-hooks.sh
  • bash tests/test-gen-plan.sh
  • bash tests/test-refine-plan.sh
  • git diff --check

Signed-off-by: Chao Liu chao.liu.zevorn@gmail.com
@zevorn zevorn marked this pull request as ready for review May 9, 2026 16:05
zevorn added 2 commits May 10, 2026 01:08
Signed-off-by: Chao Liu chao.liu.zevorn@gmail.com
Signed-off-by: Chao Liu chao.liu.zevorn@gmail.com
@zevorn zevorn force-pushed the codex/feature-capability-map branch from 2a0db29 to 459af3f Compare May 9, 2026 17:19
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