SMART Framework Core

SMART Framework Core e il repository open source ufficiale del metodo SMART.

Contiene il cuore documentale e operativo del framework, pensato per uso locale da persone e agenti AI.

Non contiene web app, database o automazioni SaaS.

Versione corrente del core: v0.1.0.

Cosa risolve

SMART aiuta a trasformare un bisogno progettuale in materiali pubblicabili con un processo tracciabile, verificabile e ripetibile.

Il valore principale e ridurre ambiguita, salti logici e output incoerenti.

Workflow canonico

Step 1: case-schema.json -> case.json
Step 2: case.json -> cartella-master/
Step 3: cartella-master validata -> output tool/prompt/materiali pubblicabili

Distinzioni obbligatorie

• schema: struttura e vincoli del caso (framework-documents/wizard/case-schema.json);
• caso: istanza concreta compilata (case.json);
• cartella master: base operativa completa generata in Step 2;
• derivato: output finale di Step 3.

Come iniziare

1. Leggi HOW_TO.md.
2. Leggi framework-documents/README.md.
3. Parti da templates/case.template.json.
4. Usa .agents/README.md per esecuzione con agenti.
5. Confronta con examples/.

Dove trovare cosa

• metodo e contratti: framework-documents/
• uso agentico locale: .agents/README.md
• prompt operativi fase-per-fase: prompts/runtime/
• template artefatti: templates/
• esempi: examples/
• prompt esempi rapidi: prompts/examples/

Core open source

Questo repository resta pubblico, local-first e indipendente da piattaforme private.

Struttura repository

/
|- README.md
|- HOW_TO.md
|- LICENSE
|- CONTRIBUTING.md
|- CHANGELOG.md
|- SECURITY.md
|- CODE_OF_CONDUCT.md
|- ROADMAP.md
|- .agents/
|- framework-documents/
|- prompts/
|- templates/
|- examples/
`- .github/

Contribuire

Vedi CONTRIBUTING.md.

Per issue e pull request usa i template in .github/.

Versioning

SMART Framework Core usa semantic versioning documentale.

• versione corrente: v0.1.0;
• file versione: VERSION;
• storico modifiche: CHANGELOG.md.

Roadmap sintetica

• consolidamento skills operative per agenti locali;
• miglioramento template ed esempi multi-scenario;
• estensione playbook mantenendo la catena Step 1 -> Step 2 -> Step 3.