consolidate

Files (18)

• LICENSE
• SKILL.md
• openai.yaml · agents/
• delivery-slice-template.md · assets/
• functionality-template.md · assets/
• technical-spec-template.md · assets/
• artifact-links.md · references/
• catalogue.md · references/
• context.md · references/
• decisions.md · references/
• delivery-slice-example.md · references/
• delivery-slices.md · references/
• functionality-example.md · references/
• local-document-delivery.md · references/
• proposals.md · references/
• reconciliation.md · references/
• record-format.md · references/
• technical-work.md · references/

SKILL.md (first lines)

# Consolidate

Maintain product intent, behavior, authority, and evidence for owners and agents
across sessions. Adapt representation, hierarchy, workflow, and depth to the product;
cover its relevant contract. Apply [artifact links](references/artifact-links.md)
whenever citing documents or tickets.

## Resolve authority and intent

Resolve [project configuration](../setup-beto-frega-skills/references/project-configuration.md#resolve-configuration),
including external files. Read canonical destinations, native representation,
conventions, governing decisions, maintenance sources, affected records, and existing
authorization. Preserve identifiers and settled choices.

Setup owns configuration. For an unresolved destination or convention, name the gap
and suggest `$setup-beto-frega-skills`. Continue work with known authority; prepare
clearly labeled drafts for blocked writes. Drafts remain subordinate to canonical
records; an unavailable configured replacement stays an explicit gap.

Read only relevant routes; combine them when needed:

| Route | Read when |
| --- | --- |
| [Catalogue](references/catalogue.md) | Finding or maintaining functionalities, audiences, jobs, behavior, value, and cost. |
| [Delivery slices](references/delivery-slices.md) | Recording selected increments, acceptance, dependencies, exposure, coverage, or delivery evidence. |
| [Context](references/context.md) | Maintaining direction, business context, shared rules, vocabulary links, or discovery evidence. |
| [Decisions](references/decisions.md) | Recording product/business choices, rationale, history, or their contract consequences. |
| [Proposals](references/proposals.md) | Shaping an investment proposal or pitch. |
| [Technical work](references/technical-work.md) | Preserving technical choices or preparing a scoped tracker spec. |
| [Reconciliation](references/reconciliation.md) | Maintaining implementation, deployment, release, exposure, or flags; investigating drift. |

Use [write-adr](../write-adr/SKILL.md) for architecture and the
[glossary format](../domain-modeling/CONTEXT-FORMAT.md) for definitions under configured
domain conventions. Feature behavior belongs in the catalogue; cross-functional
rules have shared authority. Link derived specs and tickets to those records.

Consolidate known knowledge; grill only consequential gaps blocking this update.
Interview handoffs retain selected increments, confirmed product/technical choices,
references, and deferred questions. Feature knowledge and ideas may exceed selected
delivery scope.

## Write the affected knowledge

Read [record format](references/record-format.md) before writing living records;
it owns consolidation, native history, bounded changelogs, template, and example.

Distinguish approval, proposals, observations, and assumptions. Approval comes from
conversation/project evidence, not code or flag configuration alone. Preserve
unknowns and discrepancies; actual-state claims carry source, time, scope, and coverage.

Use configured objects, properties, sections, and relationships. Keep one authority
per meaning; cover known behavior, exceptions, and implementation/verification
scenarios. Proportionality adjusts detail and governance, not rule coverage. Update
linked records affected by accepted changes. Label interaction illustrations
replaceable and state binding outcomes explicitly.

Exercise existing authorization within scope. Documentation maintenance does not
authorize release, flag operations, schedules, or new policy. Read reconciliation
before an authorized flag operation.

## Verify completion

Apply [local document delivery](references/local-document-delivery.md) for local edits.
Read back saved records and relationships: verify identity, representation, content,
authority/timing, source coverage, decision/shared-rule/work/evidence links, and the
whole-document record-format checks. Account for every affected record with a
verified result or named gap.

For lookups/reviews, return canonical links and findings. For changes, report saved,
proposed, unknown, and unverifiable effects separately. Drafts, acceptance,
implementation, and verified release are distinct outcomes.

From BetoFrega/skills, MIT.

More from BetoFrega/skills