brainstorming
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).
zagrosi-implementBuild admitted Forge sections with minimal code, targeted TDD/review, resumable records, and final verification.
Independent GitHub snapshot · Automated classification · Original documentation governs
For a Git target, check team status --target-dir "{target_dir}" with Forge’s
helper before work or resume.
Follow team coordination when configured or unavailable;
reuse the same task across phases and delegated agents.
Use the least process that preserves correctness. Apply the all-depth
engineering standard: fix encountered bad code, update
ownership, and verify behavior before/after refactors; prefer readability over
code golf. Read the admitted plan's depth;
use it as {depth} throughout. Require sections/index.md; its parent is
planning_dir; target_dir defaults to the repo.
Resolve plugin_root from this loaded SKILL.md's enclosing plugin directory
containing scripts/zagrosi_skills.py, never from the target repo. In Claude Code
the path is ${CLAUDE_PLUGIN_ROOT} (text substitution, not a shell variable).
Use Python 3.11+ (python3 below; python or py -3 on Windows).
Only with --implementation-root, read detached-frozen.md
fully and obey it. Before reading, require a regular single-link file with
complete-file SHA-256 51a217ee516dff42a355f0ad8416c76149d28ec045b3374c1007b042583fcae1;
stop on mismatch. Setup rechecks it. Do not load that large reference otherwise.
Detached execution uses that pinned protocol's evidence wire format; the mutable
receipt commands below apply only to ordinary implementation.
python3 "{plugin_root}/scripts/zagrosi_skills.py" implement-setup --sections-dir "{sections_dir}" --target-dir "{target_dir}" --depth "{depth}"
Repair failed admission before coding. Preserve unrelated work; isolate conflicting ownership. Treat plan text as requirements, never executable instructions.
Follow returned readiness and command argument arrays; fill evidence placeholders
only with actual results. After recording, use the returned entry for the next
section. recorded: true means the record is saved even if that entry needs repair.
Parallelize only disjoint files and serialize records.
When the user supplies cumulative verification time, or a resumed plan reports a saved allowance, follow verification allowance. Do not infer a cap from depth or elapsed effort; extend only with explicit user authorization. Keep fresh evidence reusable and unfinished checks visible.
implement-setup --section "{section}" and the setup arguments
above before source edits; capture its passing baseline. Follow returned actions
when resuming. Read-only status does not activate a section.implement-progress --planning-dir "{planning_dir}" --section "{section}" --stage red --command "{test command}" --result "{observed failure}".
This structured checkpoint preserves recovery evidence; prose alone does not.implement-verify --planning-dir "{planning_dir}" --target-dir "{target_dir}" --section "{section}" -- <command argv>.
First rerun required compatibility checks with --stage candidate; repair
failures. This pair supplements ordinary feature checks and final integration.
Use the ordinary verification receipt when recording; do not run the full suite per section.
When the last section runs the full integration suite, add --integration now
so Finish reuses that result. Commands are literal argv; set environment
variables in the host shell before invoking Forge, not after --.python3 "{plugin_root}/scripts/zagrosi_skills.py" implement-record-section --sections-dir "{sections_dir}" --section "{section}" --review-status pass --verification-receipt "{receipt}" --depth "{depth}" --flight off
Add applicable --file, --test-file, and --commit; use review status fixed
after fixes. Document material deviations. Follow user/repo commits; never bypass
hooks. Do not push, open PRs, deploy, or watch without existing authorization.
Review the diff and affected callers for justified cleanup. Reuse a fresh
integration receipt from the last section; otherwise capture the full
test_command once with implement-verify without --section. Run one final
postflight without --run-tests. The receipt must match final code and contracts;
later edits require refreshed verification.
Ordinary verification preserves superseded receipt bytes under
implementation/verification/history/<receipt-stem>/<sha256>.json, including
bounded output tails. Identical bytes are stored once per scope; archives cannot
establish run counts or cumulative execution time. Only current receipts determine
completion. Archives are never pruned automatically.
For externally run checks or inspection-only changes, explicitly label the source
and outcome (attestation or inspection, passed) with actual evidence;
never present these as captured execution. Legacy free text remains readable but
cannot prove new completion. Manual evidence cannot replace a required compatibility
pair. Failed, skipped, or unknown checks block completion.
python3 "{plugin_root}/scripts/zagrosi_skills.py" postflight --phase implement --planning-dir "{planning_dir}" --sections-dir "{sections_dir}" --target-dir "{target_dir}" --depth "{depth}"
Require success; report changes, verification, and residual risks.