<h1 align="center">simplicio-prompt</h1>

<p align="center">
  <strong>Runtime tuple-space per fan-out reale di subagenti, consenso, prompt cache-aware ed esecuzione AI attenta ai costi.</strong><br />
  <em>I comandi restano in inglese per copiarli esattamente.</em>
</p>

<p align="center">
<a href="https://github.com/wesleysimplicio/simplicio-prompt/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/wesleysimplicio/simplicio-prompt?style=flat-square" /></a>
<a href="https://pypi.org/project/simplicio-prompt/"><img alt="PyPI" src="https://img.shields.io/pypi/v/simplicio-prompt.svg?style=flat-square" /></a>
<a href="https://www.npmjs.com/package/simplicio-prompt"><img alt="npm" src="https://img.shields.io/npm/v/simplicio-prompt.svg?style=flat-square" /></a>
<a href="../LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-yellow?style=flat-square" /></a>
</p>

<p align="center">
<a href="../README.md">English</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.es-ES.md">Español</a> | <a href="README.ja-JP.md">日本語</a> | <a href="README.ko-KR.md">한국어</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.it-IT.md">Italiano</a> | <a href="README.fr-FR.md">Français</a> | <a href="README.ru-RU.md">Русский</a> | <a href="README.pl-PL.md">Polski</a> | <a href="README.hi-IN.md">हिन्दी</a> | <a href="README.ar-SA.md">العربية</a> | <a href="README.he-IL.md">עברית</a> | <a href="README.ms-MY.md">Bahasa Melayu</a> | <a href="README.id-ID.md">Bahasa Indonesia</a>
</p>

<p align="center">
  <img src="../docs/assets/simplicio-prompt-hero.jpg" alt="simplicio-prompt preview" width="860" />
</p>

---

## Sintesi breve

Runtime tuple-space per fan-out reale di subagenti, consenso, prompt cache-aware ed esecuzione AI attenta ai costi.

## DNA del progetto

Questa pagina localizzata mantiene il percorso rapido. La guida tecnica completa restaurata vive nel README principale, cosi il progetto conserva voce e dettagli operativi originali.

- Full restored guide: [../README.md](../README.md)
- Local project note: simplicio-prompt is the contract layer: fan-out, consensus, routing discipline, and repeatable prompt behavior for agents that need more than a clever single response. The old README held the runtime vocabulary and benchmark context; the new structure now brings that depth back instead of flattening it into marketing copy.

## Avvio rapido

```bash
pip install -U simplicio-prompt
simplicio-subagents --help
npm install simplicio-prompt
```

## Cosa fa

- Separates task contract from execution strategy.
- Runs fan-out profiles from quick to 600-lane max breadth.
- Writes reusable JSON/Markdown evidence reports for orchestrators.
- Keeps the kernel dependency-free for Python runtime usage.

## Perché questo README è pensato per attirare attenzione

- promessa chiara nella prima schermata
- lingue prima dell’installazione
- badge e hero per fiducia immediata
- quick start copiabile
- prove prima dei dettagli lunghi
- grafico stelle come social proof

## Come funziona

```mermaid
flowchart LR
  mapper["simplicio-mapper
repo context"] --> current["simplicio-prompt
this project"]
  prompt["simplicio-prompt
reasoning runtime"] --> current
  current --> evidence["validated evidence
tests, docs, screenshots"]
  current --> sprint["simplicio-sprint
delivery loop"]
```

## Prove e validazione

- The package is dual-published to PyPI and npm.
- The fan-out runtime is used by Simplicio CLI and SendSprint planning paths.
- Changelog documents local Ollama defaults and real-stack evidence routing.

## Ecosistema Simplicio

- [simplicio-mapper](https://github.com/wesleysimplicio/simplicio-mapper) supplies repo context before interpretation.
- [simplicio-cli](https://github.com/wesleysimplicio/simplicio-dev-cli) executes focused code tasks with verification.
- [simplicio-prompt](https://github.com/wesleysimplicio/simplicio-prompt) provides fan-out and consensus runtime patterns.
- [simplicio-sprint](https://github.com/wesleysimplicio/simplicio-sprint) turns cards into draft PR delivery loops.

## Standard di documentazione

- [YOOL_TUPLE_HAMT.md](../YOOL_TUPLE_HAMT.md)
- [CONTRIBUTING.md](../CONTRIBUTING.md)
- [docs/readme-globalization-standard.md](../docs/readme-globalization-standard.md)

## Storico stelle

<a href="https://www.star-history.com/#wesleysimplicio/simplicio-prompt&Date">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-prompt&type=Date&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-prompt&type=Date" />
    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=wesleysimplicio/simplicio-prompt&type=Date" />
  </picture>
</a>

## Licenza

MIT. See [LICENSE](../LICENSE).
