Decompose a plan the gate accepts

Cut one parent record, an epic or a feature, into children that each do something a consumer can see. The plan gate refuses an incomplete child before any build starts.

Rules

• Slice vertically. Each child changes something a consumer can see, so verify has something to check. A schema-only or tests-only child is a horizontal cut.
• Give every child a runnable demonstration in backticks, on one line.
• Scope the file that produces the value, not the file that shows it, and name the child's own file, never a directory glob. Scoping shows how to find the producer.
• Flatten, never nest. A child that needs children was cut wrong.

Steps

1. Find the producer of each value the work changes, as scoping shows.

2. Write plan.toml:

   [[children]]
   title = "Refuse a flag with no expiry"
   acceptance = ["When basicly flag add runs without --expires, the command shall exit 2 and name the flag."]
   scope = ["src/basicly/flags.py", "tests/test_flags.py", "changelog.d/PARENT-ID.1.added.md"]
   depends_on = []
   demonstration = "`basicly flag add beta --owner me` exits 2 and prints the missing --expires"

3. Preview it with --dry-run. A line that reads `PATH`: collapses the grouping means more than one child writes that path. Give the path to one child, or list it under shared when each child only appends to it. Then run without --dry-run:

   basicly decompose PARENT-ID --plan plan.toml --dry-run
   basicly decompose PARENT-ID --plan plan.toml

The plan fields

Spending limits and historical integrity fields are optional.