align-issue-card

Align issue cards with ExecPlans against AGENTS.md and PLANS.md standards.

2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/EEstevanell/codex-planning-kit --skill align-issue-card
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: align-issue-card
Source: https://github.com/EEstevanell/codex-planning-kit/tree/main/.codex/skills/align-issue-card
Command: npx skills add https://github.com/EEstevanell/codex-planning-kit --skill align-issue-card

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

Validate alignment between an issue card and its ExecPlan by enforcing standards defined in AGENTS.md and PLANS.md, reducing ambiguity and handoff risk.

Core Features & Use Cases

  • Compliance verification: Checks alignment with AGENTS.md and PLANS.md.
  • Junior-proof edits: Produces exact patch-style changes to resolve gaps.
  • Traceability: Outputs a rubric and gap log to guide reviewers and contributors.

Quick Start

Use the align-issue-card skill to validate an issue card at ISSUE_PATH against an ExecPlan at EXECPLAN_PATH and generate a ready-to-implement remediation plan.

Frequently Asked Questions about align-issue-card

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify an issue card complies with an ExecPlan?

To verify issue card compliance with an ExecPlan, align the issue card against AGENTS.md and PLANS.md standards. This process checks the ISSUE_PATH and EXECPLAN_PATH to produce a readiness assessment, a gap log with severity, and exact patch-style edits to resolve ambiguities.

What is issue card alignment for junior-proof readiness?

Issue card alignment is a compliance verification process that enforces standards defined in AGENTS.md and PLANS.md. It reduces ambiguity and handoff risk by generating a ready-to-implement rubric and concrete patch-style changes, ensuring tasks are clear enough for junior developers.

How do I generate patch-style edits to fix ExecPlan gaps?

Generate patch-style edits by validating an issue card at ISSUE_PATH against an ExecPlan at EXECPLAN_PATH. The output includes a remediation plan with concrete changes to fix issues, a gap log detailing severity, and a traceability rubric for reviewers.

Do I need AGENTS.md and PLANS.md files to validate issue card compliance?

Yes, you need AGENTS.md and PLANS.md files because they define the compliance standards enforced during the issue card validation process. The Skill cross-references these documents with the issue card and ExecPlan to generate the readiness assessment and gap log.

What's the best way to trace ExecPlan gaps in an issue card?

The best way to trace ExecPlan gaps is to align the issue card with its ExecPlan to produce a gap log with severity ratings. This outputs a traceability rubric that guides reviewers and contributors by pinpointing exact compliance failures and required fixes.