init-projet

Generates a validated CLAUDE.md project contract through closed-ended questions and bootstraps the BRAIN error journal.

1|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/YoLaub/JohnAI --skill init-projet-yolaub
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init-projet
Source: https://github.com/YoLaub/JohnAI/tree/main/.claude/skills/init-projet
Command: npx skills add https://github.com/YoLaub/JohnAI --skill init-projet-yolaub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Starting a new project with an AI assistant often means re-explaining context every session. This Skill captures the project context once by writing a CLAUDE.md contract through structured closed-ended questions, so future sessions never need to re-ask what is already decided. ## Core Features & Use Cases - Closed-Question Framing: Asks only yes/no or multiple-choice questions (max 4 per round) with a recommended option, covering business context, scope, stack, and working method. - CLAUDE.md Generation: Writes a concise, validated CLAUDE.md at the project root following a strict template, marking undecided items as _à décider_ instead of inventing values. - BRAIN & Error Journal Bootstrap: Creates ~/brain/<PROJECT_KEY>/ with rules/, an empty bag.ndjson, and appends an error-logging block to CLAUDE.md in append-only mode. - Use Case: When starting a new client project, trigger this Skill to produce a validated CLAUDE.md and an initialized error journal before any code is written. ## Quick Start Ask the assistant to initialize the project by saying "init projet" and answer the closed-ended questions to generate the CLAUDE.md.

Frequently Asked Questions about init-projet

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

FAQPage Schema
How do I create a CLAUDE.md file for a new project?▼

Trigger the init-projet skill, which asks closed-ended questions about business context, scope, stack, and method, then writes a validated CLAUDE.md at the project root. No code is generated until you approve the file.

What questions does the project initialization process ask?▼

It asks only closed questions (yes/no or 2-4 choices), maximum four per round, covering business context, deliverable scope, stack and hosting, and working method such as TDD and git strategy. Anything deducible from existing files is never asked.

What is the BRAIN directory and error journal?▼

The BRAIN is a per-project directory at ~/brain/<PROJECT_KEY>/ containing a rules folder and a bag.ndjson file. After a non-trivial bug is fixed, one structured line with trigger, symptom, root cause, and severity is appended to bag.ndjson.

Does init-projet modify existing CLAUDE.md content?▼

No. All writes to an existing CLAUDE.md are append-only, and existing blocks are never duplicated. The final verification step confirms no pre-existing content was modified.

When should I use compile-rules instead of init-projet?▼

Use init-projet at project kickoff to create the CLAUDE.md and empty journal. Use compile-rules later, once the error journal contains entries, to compile them into reusable rules and activate the dormant rules block.