plan-addendum

Generate Design Review Addendums with fixed templates for TEP governance.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/KingSharkG/ai-agents-workflow --skill plan-addendum
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-addendum
Source: https://github.com/KingSharkG/ai-agents-workflow/tree/main/skills/plan-addendum
Command: npx skills add https://github.com/KingSharkG/ai-agents-workflow --skill plan-addendum

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Produces a structured Design Review Addendum for subtasks in design-hook domains. Use when the Design Agent must emit an auditable addendum that Lead will merge into the TEP.

Core Features & Use Cases

  • Append inside the subtask's ai-work.md the design-addendum placeholder and a detailed Metadata block, followed by UX findings, design constraints, and open questions as required by governance.
  • Write diagnostics (telemetry and context manifest) to <subtask_id>/summary.md for auditability.
  • Enforce content structure with a fixed Output Template to ensure consistency in governance documentation.

Quick Start

Append the addendum to the subtask's ai-work.md using the predefined template and emit diagnostics to the subtask's summary.md.

Output Target

Append to <!-- section:plan-addendum --> in the subtask's ai-work.md. The placeholder MUST already exist — if absent, raise a Blocker Escalation. Also write diagnostics (telemetry line + context manifest subsection) to <subtask_id>/summary.md.

Output Template

Append inside <!-- section:plan-addendum -->:

<!-- section:design-metadata -->
## Metadata
- **task_id**: <from spec section>
- **subtask_id**: <from spec section>
- **agent**: design-agent
- **created_at**: <ISO 8601 UTC>
<!-- /section:design-metadata -->

<!-- section:design-findings -->
## UX Findings
- <finding or "none">
<!-- /section:design-findings -->

<!-- section:design-constraints -->
## Required Constraints for TEP
- <specific Lead-facing constraint to merge into the TEP>
<!-- /section:design-constraints -->

<!-- section:design-open-questions -->
## Open Questions
- <question or "none">
<!-- /section:design-open-questions -->

Then write diagnostics to <subtask_id>/summary.md:

  • Append your telemetry line under ## Telemetry
  • Append your ### design-agent context manifest subsection under ## Context Manifest

Rules

  • Write the addendum content first, then finalize manifests and telemetry.
  • Keep the content specific enough that the Lead can merge it into the TEP without follow-up questions.
  • Do not emit executor-facing implementation steps.

Frequently Asked Questions about plan-addendum

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

FAQPage Schema
How do I create an auditable design review addendum for subtask governance?

To create an auditable design review addendum, append a structured Metadata block, UX findings, design constraints, and open questions to the subtask's ai-work.md file using a fixed output template for traceability.

What is the best way to append design governance diagnostics to a subtask summary?

The best way to append design governance diagnostics is to write telemetry lines and a context manifest subsection directly into the subtask's summary.md file, ensuring full auditability across design tasks.

Do I need a pre-existing placeholder in ai-work.md to generate a design addendum?

Yes, you need a pre-existing placeholder. The design addendum must append to a specific section in ai-work.md; if this placeholder is absent, the process triggers a Blocker Escalation.

When should I use a formal addendum for TEP design governance?

You should use a formal addendum for TEP design governance when a Lead requires structured, auditable documentation to merge into the TEP and ensure traceability across design subtasks.

What content structure is enforced for merging design constraints into a TEP?

A fixed content structure is enforced for merging design constraints into a TEP, requiring specific Lead-facing constraints, metadata, UX findings, and open questions without executor-facing implementation steps.

Why does my design addendum process raise a Blocker Escalation?

Your design addendum process raises a Blocker Escalation because the required section placeholder is missing from the subtask's ai-work.md file, preventing the addendum from being appended.