Skip to content

Add capability map to gen-plan#151

Open
zevorn wants to merge 6 commits into
PolyArch:devfrom
zevorn:codex/feature-capability-map
Open

Add capability map to gen-plan#151
zevorn wants to merge 6 commits into
PolyArch:devfrom
zevorn:codex/feature-capability-map

Conversation

@zevorn

@zevorn zevorn commented May 9, 2026

Copy link
Copy Markdown
Contributor

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
…tion

Signed-off-by: Chao Liu <chao.liu@processmission.com>

# Conflicts:
#	README.md
#	commands/gen-plan.md
#	docs/usage.md
#	prompt-template/codex/full-alignment-review.md

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e0857476d4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/setup-rlcr-loop.sh Outdated
Comment thread scripts/setup-rlcr-loop.sh Outdated
Signed-off-by: Chao Liu <chao.liu@processmission.com>
@zevorn

zevorn commented Jun 13, 2026

Copy link
Copy Markdown
Contributor Author

@codex review again

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 43a57a0faf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/setup-rlcr-loop.sh Outdated
Signed-off-by: Chao Liu <chao.liu@processmission.com>
@zevorn

zevorn commented Jun 13, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep them coming!

Reviewed commit: 8d896a4f80

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@zevorn zevorn changed the title [codex] Add capability map to gen-plan Add capability map to gen-plan Jun 13, 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