preflight-modulo

Enforce a three-phase pre-flight workflow for module edits under Modules/<X>/.

Updated May 14, 2024
One-click install
npx skills add https://github.com/wagnerra23/oimpresso.com --skill preflight-modulo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: preflight-modulo
Source: https://github.com/wagnerra23/oimpresso.com/tree/main/.claude/skills/preflight-modulo
Command: npx skills add https://github.com/wagnerra23/oimpresso.com --skill preflight-modulo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents accidental technical and process drift by forcing a Tier 0 pre-flight checklist before any modification inside Modules/<X>, ensuring the AI reads the correct module rules and required artifacts.

Core Features & Use Cases

  • Mandatory 3-phase workflow (PRE-FLIGHT/DURING/POST): blocks editing until required briefing and prohibitions are read, enforces incremental commit/push, and ensures changes become documented via PR and tests.
  • Module-specific guardrails: requires reading memory/requisitos/<X>/SPEC.md, relevant RUNBOOK/CAPTERRA documents, and module charter files before touching controllers/services/entities/migrations and other module code.
  • Defenses-in-depth via hooks and prohibitions: relies on dedicated warning and blocking hooks plus memory/proibicoes.md to reduce repeated mistakes like editing without reading.

Quick Start

Activate preflight-modulo before modifying any file under Modules/<X>/ to ensure the required briefing and prohibitions are read and the change is logged through the full 3-phase workflow.

Frequently Asked Questions about preflight-modulo

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

FAQPage Schema
How do I prevent code drift when modifying multi-tenant module files?

To prevent code drift when modifying multi-tenant module files, enforce a three-phase pre-flight workflow that mandates reading SPEC.md and charter artifacts before editing controllers, services, entities, or migrations. This ensures all changes comply with established module rules.

What is a pre-flight workflow for module development safety hooks?

A pre-flight workflow for module development safety hooks is a mandatory three-phase process (PRE-FLIGHT, DURING, POST) that blocks file editing until required briefings and prohibitions are read, ensuring changes are committed, pushed, and documented via PRs and tests.

How do I enforce ADR compliance before editing Inertia TSX pages?

Enforce ADR compliance before editing Inertia TSX pages by consulting decisions-search for relevant Architecture Decision Records and reading memory/proibicoes.md primary rules during the pre-flight phase to block rule-violating edits.

Does the pre-flight workflow apply to database migrations and observer edits?

Yes, the pre-flight workflow applies to database migrations and observer edits. It enforces safe handling for any database-related actions and requires reading module-specific RUNBOOK and CAPTERRA documents before modifying files under the Modules directory.

How to maintain git commit discipline across multi-tenant module updates?

Maintain git commit discipline across multi-tenant module updates by applying workflow guardrails that enforce incremental commit and push steps during the POST phase, ensuring every modification is logged through a complete PR and test documentation cycle.