CodeGuide

Cos'è CodeGuide?

CodeGuide crea contesto basato su specifiche per strumenti di coding AI. Aiuta a trasformare un'idea o un codebase GitHub esistente in documenti di progetto strutturati—come PRD, specifiche tecniche e wireframe—che i modelli AI possono consultare durante l'implementazione del software.

Lo scopo principale è ridurre il problema della “black box” nello sviluppo assistito da AI creando una knowledge base di progetto con contesto più chiaro per pianificazione e documentazione, sia partendo da una descrizione sia estendendo un repository legacy.

Caratteristiche Principali

• Generazione di documentazione basata su specifiche (input in inglese semplice): Descrivi il tuo progetto in inglese semplice per generare un kit di documentazione, inclusi PRD, indicazioni sullo stack tecnologico e wireframe.
• Documentazione di codebase GitHub esistenti: Fornisci progetti GitHub esistenti per mappare il codebase, così gli strumenti AI hanno un contesto più chiaro su cosa contiene il repository.
• Workflow di documentazione AI (domande chiarificatrici → piano → docs): Fornisci un brief del progetto e rispondi a domande aperte (es. comportamento delle notifiche, onboarding, vincoli delle feature) per modellare i documenti risultanti.
• Agente di coding autonomo Software v2: Usa un agente che può analizzare un codebase, pianificare documentazione ed eseguire task di coding “autonomamente” per sessioni prolungate.
• Interfaccia unificata per più tool CLI / routing dei modelli: Opera con un'unica interfaccia mentre più modelli AI lavorano in sincronia; un router di modelli seleziona i modelli per diverse parti del workflow.
• Estensione Chrome per generazione browser-based: Genera PRD, specifiche tecniche e documentazione direttamente dal browser.
• Editor UI on-screen: Modifica on-screen e coordina più agenti in parallelo per fix UI o aggiunte di feature.
• Starter kit per ridurre lo sforzo di setup: Boilerplate open-source per modelli di coding AI includono infrastruttura comune come autenticazione, configurazione database e configurazione pagamenti Stripe (come descritto per i template).

Come Usare CodeGuide

1. Inizia con un'idea o un repo: Descrivi in inglese semplice cosa vuoi costruire, o indica a CodeGuide un progetto GitHub esistente.
2. Rispondi alle domande sul progetto quando sollecitate: Usa le domande chiarificatrici per specificare comportamento del prodotto e vincoli.
3. Genera il kit di documentazione: Produci gli output necessari per l'implementazione, come PRD, specifiche tecniche, wireframe e artefatti di pianificazione correlati.
4. Usa Software v2 per l'esecuzione: Se passi al coding e implementazione, avvia l'agente autonomo per analizzare il codebase e seguire la documentazione pianificata.
5. Opzionalmente usa l'estensione Chrome: Genera PRD/specifiche tecniche/documentazione dal tuo workflow browser.

Casi d'Uso

• Trasforma un'idea app in specifiche pronte per l'implementazione: Uno sviluppatore descrive un concept app (es. app mobile vs. sito web) e risponde a domande sul comportamento del prodotto per ottenere PRD, specifiche tecniche e wireframe.
• Documenta un repository GitHub legacy per sviluppo AI: Quando lavori con codice vecchio difficile da interpretare, fornisci il repository per ottenere un contesto mappato e consumabile da AI per task di coding successivi.
• Pianifica requisiti prodotto prima di usare un assistente di coding AI: Usa le specifiche generate come input strutturato così uno strumento di coding AI può implementare feature basate su requisiti espliciti anziché prompt ad-hoc.
• Esegui lavoro di coding autonomo con un agente: Usa Software v2 per coordinare analisi codebase, pianificazione ed esecuzione coding su una sessione più lunga con interfaccia unificata.
• Migliora o estende una UI iterativamente: Usa l'editor on-screen per correggere issue UI o aggiungere feature mentre più agenti lavorano in parallelo.

FAQ

CodeGuide genera documentazione da una descrizione, un repository o entrambi?

CodeGuide supporta entrambi: può generare documenti da un'idea in semplice inglese e può creare documentazione per codebase GitHub esistenti mappando il repository per il contesto AI.

Che tipi di documenti può produrre CodeGuide?

Il sito descrive PRD, specifiche tecniche e wireframe come output principali, insieme a un più ampio “kit di documentazione” legato al brief del progetto.

Cos'è Software v2?

Software v2 è descritto come un agente di coding autonomo che può analizzare codebase, pianificare documentazione ed eseguire codice, con un'interfaccia unificata e più modelli sincronizzati.

Come aiuta il prodotto con le allucinazioni AI?

Il sito presenta l'approccio come la creazione di una knowledge base del progetto e specifiche/contesto strutturato che i modelli AI possono consultare, per ridurre il “tentativo a tentoni” causato da contesto mancante o poco chiaro.

Ci sono strumenti per usare CodeGuide fuori dall'app principale?

Sì. Il sito menziona un'estensione Chrome per generare PRD, specifiche tecniche e documentazione direttamente dal browser.

Alternative

• Scrittura manuale di PRD/specifiche tecniche + assistente AI per coding: Scrivi la documentazione da solo (o con una chat AI generale) e forniscila a uno strumento di coding; differisce perché si basa su specifiche create dall'utente anziché su mappatura del repository e flusso di generazione strutturato.
• Copilot AI per coding generici: Strumenti focalizzati su generazione e refactoring di codice potrebbero non fornire lo stesso kit di documentazione end-to-end (PRD/specifiche tecniche/wireframe) o mappatura del repository descritta qui.
• Strumenti di analisi codebase con priorità alla documentazione: Approcci centrati sulla generazione di documentazione dal codice sorgente (senza flusso spec/PRD) possono aiutare la comprensione ma potrebbero non produrre gli stessi artefatti di pianificazione legati ai requisiti di prodotto.
• Template/boilerplate iniziali con pianificazione separata: Usare boilerplate può ridurre il tempo di setup, ma dovresti comunque avere un altro processo per generare PRD/specifiche tecniche e wireframe per flussi di coding AI.