Export Plan Review Comments

Export Plan Review Comments

Export the final review comments without re-reviewing the plan, changing verdicts, or implementing anything.

Resolve the source and target

1. Identify exactly one plan file from the user request or the completed review:

   .ai/impl_plans/<plan-id>.md
   

   If more than one plan is plausible, ask instead of guessing.

2. Resolve the review timestamp from the exact scratchpad paths cited by the comments:

   .ai/impl_plans/<plan-id>/scratchpads/<YYMMDD-HHMM>/...
   

   Reuse that timestamp verbatim. Do not generate the current time, glob scratchpad directories, or reuse a timestamp from another review. If no exact review timestamp is recoverable, ask the user.

3. Write to:

   .ai/impl_plans/<plan-id>/findings/<YYMMDD-HHMM>/finding.md
   

4. Treat every item actually present in the final review's actionable-comments section as one survived finding. Do not export summaries, coverage notes, closed candidates, intermediate commentary, or test-checklist repetitions.

Preserve each comment

• Keep the original review wording almost verbatim.
• Do not normalize findings into a new schema.
• Do not rewrite links, severity labels, verdicts, recommendations, rationales, action text, or scratchpad paths.
• Make only a tiny edit when required to make a finding understandable on its own.
• Keep the original numbering text inside the block body.
• Preserve Markdown lists and blank lines within a comment.

Wrap each finding in a separate region:

<!-- comment:begin slug="concise-kebab-case-slug" -->
1. **Severity:** Major
   **Location:** ...
   **Problem:** ...
   **Recommendation:** ...
   **Rationale:** ...
   **Scratchpad:** ...
<!-- comment:end slug="concise-kebab-case-slug" -->

Use a unique lowercase kebab-case slug. The begin and end slugs must match. Keep only blank lines between regions and no document-level introduction or summary.

Write safely

• Create only the timestamped findings directory and finding.md.
• Use apply_patch for the file content.
• Do not modify the implementation plan, scratchpads, application code, tests, or documentation.
• If the target already exists with different content, do not overwrite it unless the user explicitly requested replacement or update.

Validate

Run the bundled validator with the exact number of exported review comments:

python3 .agents/skills/export-plan-review-comments/scripts/validate_comments_export.py \
  .ai/impl_plans/<plan-id>/findings/<YYMMDD-HHMM>/finding.md \
  --expected-count <count>

Fix every validation error before finishing. Then read the file once to confirm that wording and links still match the source comments.

Respond

Reply with only a clickable link to the created file:

[.ai/impl_plans/<plan-id>/findings/<YYMMDD-HHMM>/finding.md](.ai/impl_plans/<plan-id>/findings/<YYMMDD-HHMM>/finding.md)