Skip to content
cccskills
FreePublished on GitHub

flow-audit

Enable, record, query, summarize, or verify the opt-in PWDEV Flow semantic audit trail. Use when the user asks what Flow actions occurred, wants audit integrity checked, or needs a portable JSONL record of workflow gates and artifacts.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md2.4 KB
  • agents/openai.yaml207 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Operate the PWDEV Flow Audit Trail

Read audit, safety, and artifacts. Resolve flow_audit.py from this installed plugin and pass its absolute path to python3 with the active repository root.

Route

  • enable updates only .planning/flow/config.json after an explicit request and preserves unknown configuration fields.
  • summary reports counts by action, skill, and phase.
  • events returns the latest valid semantic events, optionally filtered by an allowed action.
  • verify checks every non-empty JSONL line and returns integrity errors without repairing them.
  • record appends one event only after the described semantic action actually occurred.

Use the helper rather than parsing or appending JSONL with ad hoc shell commands.

Procedure

  1. Confirm the repository root and inspect .planning/flow/config.json without reading secrets.
  2. For enable, require explicit intent, set audit to true, preserve unknown fields, and run verify. Do not create a synthetic historical trail.
  3. For queries, run the matching helper command and report invalid-trail failures before any counts.
  4. For record, choose one allowed action from the audit contract, a canonical flow-* skill, and only the smallest non-sensitive structured detail needed. Record after the gate, write, decision, archive, migration, or phase outcome succeeds.
  5. Report helper exit status and whether a write occurred. Recording while disabled is a successful no-op, not an audit event.

Constraints

  • Never include prompts, environment variables, file contents, secrets, credentials, tokens, or private-key paths.
  • Do not promise complete runtime telemetry: this trail records semantic Flow events only and uses no hooks.
  • Do not repair, truncate, reorder, or replace an invalid trail without a separate explicit instruction.
  • Audit failure must be visible but does not retroactively invalidate the workflow event it attempted to record.

Output

Return MODE, AUDIT_ENABLED, command result, integrity status, event count when applicable, limitations, and NEXT.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Accessibility auditing and remediation skill for Vue 3 + Reka UI. Use when reviewing components, verifying WCAG 2.1 AA, fixing ARIA issues, or validating keyboard navigation in Reka UI components.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Infraestrutura para IA — GPU, servidores MCP, gateway de LLM, pipeline de inferência, custo de token, cache semântico e observabilidade de modelo. Use quando o usuário disser "GPU", "MCP server", "LLM", "inferência", "modelo", "gateway de IA", "custo de token", "rate limit da API de IA", "self-host de modelo".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Escreve texto alternativo e descrição de imagem para peças de rede social. Use quando o usuário disser "alt text", "texto alternativo", "descrição da imagem", "acessibilidade da peça", "descrever para leitor de tela", ou automaticamente antes de qualquer publicação. Obrigatório em todas as peças — em carrossel, um por slide.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Organiza, compara e seleciona entre as variações geradas, e publica a grade de comparação como Artifact para aprovação do time. Use quando o usuário disser "qual dessas", "comparar as variações", "escolher a melhor", "mostrar as opções", "montar grade de aprovação", ou após qualquer lote de geração. Selecionar é trabalho, não detalhe.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Aumenta resolução e qualidade de imagem via Freepik/Magnific, ou orienta o processo manual quando não há chave. Use quando o usuário disser "upscale", "melhorar a resolução", "a imagem está pixelada", "Magnific", "Freepik", "aumentar a imagem", "imagem pequena demais". Gasta crédito — exige confirmação.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

CI/CD e automação — GitHub Actions, Terraform, OpenTofu, Ansible, n8n. Use quando o usuário disser "pipeline", "CI/CD", "GitHub Actions", "workflow", "terraform", "ansible", "n8n", "automatizar", "deploy automático", "IaC".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

See all skills by pwdev-solucoes

Report a problem with this skill