plan-report

Generates evidence-based completion reports for implementation plans with verified percentages and engineering benefits.

3|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/ceasarXuu/AstartesSkills --skill plan-report-ceasarxuu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-report
Source: https://github.com/ceasarXuu/AstartesSkills/tree/main/skills/plan-report
Command: npx skills add https://github.com/ceasarXuu/AstartesSkills --skill plan-report-ceasarxuu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams often report plan progress with vague claims like "basically complete" or "mostly done" that hide unfinished work and unverified results. This Skill inspects the actual project artifacts—code, tests, docs, configs, logs—and produces a factual implementation report with explicit completion percentages, verified engineering benefits, and honest gap analysis. ## Core Features & Use Cases - Evidence-Based Completion Scoring: Calculates overall, stage, and module completion percentages from explicit denominators using a 0/25/50/75/100 scoring scale tied to concrete evidence. - Goal Alignment & Engineering Benefit Matrices: Maps planned goals to actual work and requires concrete benefits with metrics, baselines, targets, observed results, and verification evidence. - Unfinished-Work Impact Analysis: Lists every incomplete item with a specific reason, supporting evidence, impact if left unresolved, and recommended next actions with priority and dependencies. - Use Case: After a refactor plan is executed, ask for a completion report and receive tables and Mermaid charts showing which modules are verified at 100%, which are partial, and exactly what remains blocked or deferred. ## Quick Start Use the plan-report skill to audit the current repository against our migration plan and produce a completion report with stage percentages, verified engineering benefits, and unfinished-work impact analysis.

Frequently Asked Questions about plan-report

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

FAQPage Schema
How do I report plan implementation progress with real evidence?

Provide the plan document or task list and let the skill inspect actual artifacts like code, tests, configs, and logs. It calculates completion percentages from explicit denominators and cites evidence for every completed item instead of relying on intent or guesswork.

How is completion percentage calculated in a plan report?

Completion equals verified points divided by planned points, computed at module level then rolled up to stages and overall. Modules score 0%, 25%, 50%, 75%, or 100% based on evidence, and items without verified acceptance criteria cannot reach 100%.

What counts as valid evidence for marking a task complete?

Valid evidence includes source code, passing tests, runtime logs or metrics, documentation, and review sign-off. A completed item needs at least one implementation evidence label and one verification evidence label; TODOs, placeholders, and unused scaffolds do not count.

Can the report be generated if tests cannot be run?

Yes, but affected items are marked as not verified or partial rather than complete. The report explains the verification blocker and preserves uncertainty explicitly instead of guessing at completion.

What format does the plan implementation report use?

The report follows a template with completion overview tables, stage and module completion tables, Mermaid charts, a Goal Alignment Matrix, an Engineering Benefit Matrix, an evidence matrix, an unfinished-work table, and prioritized next actions.