agustinusnathaniel/maestria
maestria handoff, iteration-limit, recon, architecture-plan, pull request, documentation-update, and diagnosis skills, with native host components in the same package
Decide between implementation approaches and write the phased plan that implements the choice. Use for trade-offs, technology or boundary choices, threat models, ADR decisions, and multi-phase features, rollouts, or migrations.
Draft or revise a pull request title and body and check it is ready for review. Use when preparing a PR, reviewing its text, refreshing it after a push, or before marking it ready.
Trace a bug, regression, failure, or crash to an evidence-backed root cause, then hand off or apply the minimal fix. Use when the cause is unknown or disputed, or when auditing where the same defect recurs.
Assess documentation impact and update affected docs for a code, API, config, or operator workflow change. Use when a change affects documented behavior, when asked to update stale docs or reconcile docs with code, or when a decision or status recorded in plans or ADRs changed. Do not use for trivial changes with no documented surface, or for drafting new product copy from scratch.
Pass outcome, constraints, evidence, blockers, and next steps between workflow stages
Bound repair and stop repeated work using verifiable termination criteria
Map unfamiliar code before changing it - entry points, call chains, data flow, boundaries, and conventions - and stop once the paths the change needs are known. Use when the change touches code you have not read or the affected surface is unclear.