commit-soap

Extract A and P sections from a SOAP and format a git commit message.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/iago-leal/skills --skill commit-soap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-soap
Source: https://github.com/iago-leal/skills/tree/main/mdcu-framework/commit-soap
Command: npx skills add https://github.com/iago-leal/skills --skill commit-soap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gerador de mensagens de commit derivadas do SOAP da sessão atual. Lê a Avaliação (A) e o Plano (P) do SOAP registrado pela skill rsop e formata uma mensagem de commit que preserva o contexto cognitivo da sessão. ATIVE SEMPRE que o usuário digitar /commit-soap, pedir para commitar com contexto da sessão, encerrar uma sessão de trabalho com commit pendente, ou quando a skill rsop finalizar o registro de um SOAP e houver alterações a commitar. Também ative quando o usuário mencionar "commit com A+P", "commit com avaliação e plano", ou "commit da sessão". NÃO ative para commits intermediários triviais (formatação, typo, WIP, checkpoints) — esses usam git commit padrão.

Core Features & Use Cases

  • Gera uma mensagem de commit que captura o contexto cognitivo do A+P do SOAP.
  • Aplica-se ao encerramento de sessões ou à finalização de features com contexto claro, garantindo rastreabilidade.
  • Suporta link para o SOAP completo e evita usos inadequados para commits triviais.

Quick Start

Use /commit-soap para gerar uma mensagem de commit que incorpore o A+P do SOAP atual.

Frequently Asked Questions about commit-soap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a git commit message from my current session context?

To generate a git commit message from session context, use the /commit-soap command to extract the Assessment (A) and Plan (P) sections from the current SOAP. This formats the cognitive context into a concise, structured git commit message.

What is the SOAP format for structuring git commits?

The SOAP format for git commits structures messages by extracting the Assessment (A) and Plan (P) sections from a session note. It ensures the commit message follows an A: and P: structure, preserving the cognitive context of the work session.

How do I preserve work session assessment and plan details in a git commit?

You preserve work session assessment and plan details by applying the /commit-soap command when finalizing a session. It reads the A and P sections from the SOAP registered by the rsop skill and formats them directly into the commit message.

Should I use context-aware commits for trivial WIP or formatting changes?

You should not use context-aware commits for trivial WIP, formatting, or typo changes. This approach is reserved for finalizing sessions or features with clear context, ensuring traceability for significant work rather than intermediate checkpoints.

Can I link a git commit message to the full SOAP session note?

Yes, you can link a git commit message to the full SOAP session note. The generated commit message follows the A: and P: structure and includes an optional Refs line pointing to the complete SOAP record for full traceability.

Does commit-soap work without the rsop skill?

commit-soap relies on the rsop skill to function, as it reads the Assessment and Plan sections from the SOAP registered and stored by rsop. It activates when a SOAP exists and the session needs to be finalized with a pending commit.