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/data/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. Instrumentation (si activée) - Enregistrer le début de phase :

    bash
    node tools/instrumentation/collector.js phase-start '{"phase":"BREAK","skill":"factory-intake"}'
    node tools/instrumentation/collector.js skill '{"skill":"factory-intake"}'
    
  2. Vérifier Gate 0 : Valider input/requirements.md

    bash
    node tools/gate-check.js 0
    
    • 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
  3. 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"
    
  4. Déléguer à l'agent analyst via Task tool :

    bash
    # Instrumentation (si activée)
    node tools/instrumentation/collector.js agent '{"agent":"analyst","source":"factory-intake"}'
    
    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)"
    )
    
  5. 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"
  6. Exécuter Gate 1 : node tools/gate-check.js 1

  7. Logger via :

    bash
    node tools/factory-log.js "BREAK" "completed" "Phase BREAK terminée - X questions posées, Y répondues"
    
  8. 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.

Didn't find tool you were looking for?

Be as detailed as possible for better results