Te templateplanmarkdownproductstable

Implementation Plan

A plan with an alternatives table, scope, numbered approach, tests, risks, dependencies, and backward compatibility. No TBD or TODO in the final draft. Required before non-trivial work starts.

id template/planv1.0.0placeholders 9

Skeleton

# Plan — {{title}}

## Objective

{{objective}}

## Alternatives

| Alternative | Pros | Cons | Verdict |
|---|---|---|---|
{{alternatives_rows}}

## Scope

{{scope}}

## Approach

{{approach}}

## Testing

{{testing}}

## Risks

{{risks}}

## Dependencies

{{dependencies}}

## Backward compatibility

{{compatibility}}

Rendered example

# Plan — Template class

## Objective

Give runtimes fillable document skeletons for the documents the constitution requires.

## Alternatives

| Alternative | Pros | Cons | Verdict |
|---|---|---|---|
| Do nothing | no work | agents keep guessing document shapes | rejected |
| Keep prompt/output-schema prose | no new class | prose is not a skeleton a runtime can fill | rejected |
| New template class | fillable, typed, exampled | ninth class; nav grows | chosen |

## Scope

Create schemas/template-v1.json and atoms/template/*.json; modify scripts/build-exports.py, web/src/lib/catalog.ts; delete prompt/handoff-md and prompt/plan-with-alternatives.

## Approach

1. Schema with body, placeholders, example. 2. Eight atoms from the constitution's required documents. 3. Build and tests. 4. Site pages.

## Testing

Build-script fixture for the class; a test that every {{placeholder}} in a body is declared.

## Risks

Nine nav items at 1440 px — shorten the font; move classes into a menu if it wraps.

## Dependencies

PR #53 merged to main.

## Backward compatibility

Two prompt ids are removed; nothing referenced them. The changelog names them.

Placeholders

Name	Required	What goes here	Example
`{{title}}`	yes	What the plan delivers.	Template class
`{{objective}}`	yes	One sentence.	Give runtimes fillable document skeletons.
`{{alternatives_rows}}`	yes	At least two table rows, including 'do nothing' where applicable.	\| Do nothing \| no work \| agents keep guessing \| rejected \|
`{{scope}}`	yes	Files to create, modify, delete.	create schemas/template-v1.json; modify scripts/build-exports.py
`{{approach}}`	yes	Numbered steps.	1. Schema. 2. Atoms. 3. Build. 4. Site.
`{{testing}}`	yes	What tests prove it works.	Fixture per class; placeholders match body.
`{{risks}}`	yes	What could go wrong and the mitigation for each.	Nav crowding — shorten labels.
`{{dependencies}}`	yes	What must land first.	PR #53 merged.
`{{compatibility}}`	yes	What breaks and the migration path.	Two prompt atoms removed; ids listed in the changelog.

Rules for the finished document

No 'TBD' or 'TODO' in the final draft.
Include 'do nothing' as an alternative whenever it is a real option.
Scope lists files, not features.

Produced by

skill/write-spec — write-spec
skill/project — Project

planplanningalternatives

Author convergent-systems-key. Source ai-atoms. License CC-BY-4.0. Section set from the AI Constitution's plan template (§4.10.1); migrated from prompt/plan-with-alternatives, whose prose described this shape.