charter-write

Draft Page Charter documentation from Inertia page code with human confirmation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the repetitive manual effort of writing Page Charter documentation, especially the sensitive parts like Non-Goals and Automation Anti-hooks.

Core Features & Use Cases

  • Generates a draft charter from code context: reads the target Inertia page .tsx, relevant Controller methods, and top navigation/route placement to infer Mission, Goals, UX Targets, and Automation Hooks.
  • Enforces safety on the highest-risk sections: creates placeholders for Non-Goals and Automation Anti-hooks and stops until a human confirms them, preventing anti-alucination failures.
  • Writes governed artifacts: outputs a *.charter.md draft next to the page component with status: wip for human approval before becoming live.

Quick Start

Ask: "/charter-write resources/js/Pages/{X}/{Y}" to generate a charter draft next to the corresponding Index.tsx for Wagner to review.

Frequently Asked Questions about charter-write

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

FAQPage Schema
How do I generate a page charter from existing Inertia code?▼

The page charter generation process reads your Index.tsx and matching controllers to infer Mission, Goals, UX Targets, and Automation Hooks, pausing for human confirmation on Non-Goals and Automation Anti-hooks before finalizing the draft.

What is a page charter and when do I need to write one?▼

A page charter is governed documentation defining a page's Mission, Goals, UX Targets, and Automation Hooks. You need one to establish operational boundaries and governance rules for an existing Inertia route.

Can I automatically draft Non-Goals and Automation Anti-hooks without human review?▼

No, drafting Non-Goals and Automation Anti-hooks requires human review. The process stops and requires explicit human confirmation for these sections to prevent anti-halucination failures.

Does the charter drafting process work with Laravel controllers and Inertia pages?▼

Yes, the process works with Inertia pages and Laravel controllers by reading resources/js/Pages/Index.tsx alongside matching Modules controllers and menus/topnav.php to infer the required charter context.

Where does the generated charter markdown file get saved?▼

The generated charter markdown file is saved next to the corresponding page component with a wip status, ensuring it remains a governed draft artifact pending human approval before going live.