Agent skill

factory-intake

Phase BREAK - Normalise les requirements en brief/scope/acceptance

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/factory-intake

SKILL.md

Factory Intake - Phase BREAK

Tu es l'orchestrateur de la phase BREAK.

⚠️ Phase CRITIQUE : Le cadrage du besoin détermine la qualité de tout le projet. L'interaction avec l'utilisateur pour clarifier les ambiguïtés est ESSENTIELLE.

Workflow

  1. Vérifier Gate 0 : Valider input/requirements.md

    bash
    node tools/validate-requirements.js
    
    • Si exit code = 1 → Fichier manquant, STOP
    • Si exit code = 2 → Sections manquantes/vides, STOP avec rapport
    • L'utilisateur DOIT compléter toutes les sections avant de continuer
  2. Informer l'utilisateur :

    "Phase BREAK - Cadrage du besoin
    
    Je vais analyser vos requirements et vous poser des questions de clarification.
    Vos réponses seront stockées dans docs/factory/questions.md
    
    Vous pouvez répondre :
    - Directement dans le terminal (recommandé)
    - Ou en éditant docs/factory/questions.md puis relancer /factory-intake"
    
  3. Déléguer à l'agent analyst via Task tool :

    Task(
      subagent_type: "analyst",
      prompt: "Analyse input/requirements.md. Pose les questions de clarification à l'utilisateur via AskUserQuestion. Documente les Q/R dans docs/factory/questions.md. Produis docs/brief.md, docs/scope.md et docs/acceptance.md",
      description: "Analyst - Phase BREAK (avec Q/R)"
    )
    
  4. Vérifier les outputs :

    • docs/factory/questions.md contient les questions posées et réponses
    • docs/brief.md existe et contient section "Hypothèses" (si questions non répondues)
    • docs/scope.md existe et contient sections "IN" et "OUT"
    • docs/acceptance.md existe et contient "Critères globaux"
  5. Exécuter Gate 1 : node tools/gate-check.js 1

  6. Logger via :

    bash
    node tools/factory-log.js "BREAK" "completed" "Phase BREAK terminée - X questions posées, Y répondues"
    
  7. Retourner un résumé avec :

    • Liste des artefacts créés
    • Nombre de questions posées/répondues
    • Hypothèses générées (si applicable)

Gestion des questions

Situation Action
Questions bloquantes non répondues STOP - Demander réponse
Questions optionnelles non répondues Continuer avec hypothèse explicite
Utilisateur veut répondre plus tard Pause - Expliquer comment reprendre

En cas d'échec

Si Gate 1 échoue → STOP et rapport des sections manquantes.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results