Lavorare con Claude Code

Flusso operativo: Developer → MdExplorer → CLAUDE.md → Claude Code

Claude Code è il tool CLI ufficiale di Anthropic per lo sviluppo assistito da AI. Funziona direttamente nel terminale e ha accesso al file system del progetto. Può leggere file, scrivere codice, eseguire comandi, e interagire con Git. La chiave è che legge automaticamente il file CLAUDE.md nella root del progetto come contesto.

Questo significa che le specifiche che scrivi in MdExplorer e referenzi in CLAUDE.md diventano il contesto operativo dell'AI. Più le specifiche sono dettagliate e ben strutturate, più il codice generato sarà allineato ai requisiti.

Operational flow: Developer → MdExplorer → CLAUDE.md → Claude Code

Claude Code is Anthropic's official CLI tool for AI-assisted development. It works directly in the terminal and has access to the project's file system. It can read files, write code, execute commands, and interact with Git. The key is that it automatically reads the CLAUDE.md file in the project root as context.

This means that the specifications you write in MdExplorer and reference in CLAUDE.md become the AI's operational context. The more detailed and well-structured your specs are, the more the generated code will be aligned with the requirements.

CLAUDE.md è il file che configura il contesto del progetto per Claude Code. Viene letto automaticamente all'avvio di ogni sessione e fornisce all'AI tutte le informazioni necessarie per comprendere il progetto: stack tecnologico, struttura cartelle, convenzioni, e soprattutto i riferimenti alle specifiche.

Struttura tipo di un CLAUDE.md efficace:

CLAUDE.md is the file that configures the project context for Claude Code. It is read automatically at the start of every session and provides the AI with all the information needed to understand the project: technology stack, folder structure, conventions, and most importantly the references to specifications.

Structure of an effective CLAUDE.md:

Il punto fondamentale è che CLAUDE.md fa da ponte tra le specifiche scritte in MdExplorer e l'AI di Claude Code. Quando referenzi un file di specifica (es. docs/analisi/ANALISI_FUNZIONALE.md), Claude Code può leggerlo e usarlo come contesto per generare codice coerente con i requisiti definiti.

The fundamental point is that CLAUDE.md acts as a bridge between the specifications written in MdExplorer and the Claude Code AI. When you reference a spec file (e.g. docs/analisi/ANALISI_FUNZIONALE.md), Claude Code can read it and use it as context to generate code consistent with the defined requirements.

Ci sono 4 tipologie principali di prompt che puoi usare con Claude Code, ciascuna per una fase diversa del ciclo di sviluppo. Ecco i prompt con esempi concreti:

Prompt per Analisi Funzionale

Usa questo tipo di prompt quando devi creare o espandere i requisiti funzionali di un modulo:

There are 4 main types of prompts you can use with Claude Code, each for a different phase of the development cycle. Here are the prompts with concrete examples:

Functional Analysis Prompt

Use this type of prompt when you need to create or expand the functional requirements of a module:

Prompt per Architettura Tecnica

Dopo aver definito i requisiti, usa questo prompt per generare il design tecnico:

Technical Architecture Prompt

After defining requirements, use this prompt to generate the technical design:

Prompt per Generazione Codice

Questo è il prompt più potente: Claude Code legge le specifiche e genera codice allineato:

Code Generation Prompt

This is the most powerful prompt: Claude Code reads the specs and generates aligned code:

Prompt per Aggiornamento Sprint

Dopo aver completato un task, aggiorna la documentazione di sprint:

Sprint Update Prompt

After completing a task, update the sprint documentation: