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.