squidy 1.0.0__tar.gz

squidy-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Squidy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

squidy-1.0.0/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: squidy
+Version: 1.0.0
+Summary: Setup inteligente para projetos com Agentes de IA
+Home-page: https://github.com/seomarc/squidy
+Author: Squidy
+Author-email: Squidy <contato@squidy.run>
+License-Expression: MIT
+Project-URL: Homepage, https://squidy.run
+Project-URL: Repository, https://github.com/seomarc/squidy
+Project-URL: Changelog, https://github.com/seomarc/squidy/blob/main/CHANGELOG.md
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.7.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: openai>=1.10.0
+Requires-Dist: anthropic>=0.18.0
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: cryptography>=42.0.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# 🦑 Squidy - Setup Inteligente para Projetos com Agentes de IA
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/seomarc/squidy)
+[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+**Pare de perder contexto com seu Agente de IA. Configure projetos profissionais em 2 minutos.**
+
+[Instalação](#instalação) • [Como funciona](#como-funciona) • [Documentação](https://squidy.run) • [Contribuir](#contribuir)
+
+</div>
+
+## 😤 O Problema que Resolvemos
+
+Você usa **Claude**, **ChatGPT** ou **Cursor** para programar, mas:
+
+- 🤯 **A IA esquece tudo** na próxima conversa (perda de contexto)
+- 📝 **Você reescreve** os mesmos requisitos toda semana
+- 🎨 **O agente fica "criativo"** e muda sua arquitetura sem avisar
+- 📂 **Seu projeto vira bagunça** porque ninguém documenta nada
+- ⏱️ **Gasta 30 min** configurando prompt antes de começar a codar
+
+**O Squidy resolve isso em 2 minutos.**
+
+## 🎯 O que é o Squidy?
+
+O **Squidy** é um **instalador CLI** que cria automaticamente a estrutura de governança para seus projetos com Agentes de IA (Claude, GPT-4, Cursor, etc).
+
+Em vez de você digitar 20 mensagens explicando seu projeto toda vez que abre o chat, o Squidy:
+
+1. 🎤 **Entrevista você** com 5 perguntas inteligentes
+2. 🧠 **Usa IA** para entender seu stack e regras
+3. 📋 **Gera 9 arquivos de documentação** que seu agente DEVE ler antes de começar
+4. 🔒 **Cria um "contrato"** entre você e a IA: regras, proibições, definição de pronto
+
+**Resultado:** Sua IA nunca mais perde o contexto ou sai do escopo.
+
+## 🚀 Instalação
+
+> **Nota:** o Squidy ainda não está no PyPI. Use o método clone abaixo.
+
+```bash
+# 1. Clone o repositório
+git clone https://github.com/seomarc/squidy.git
+cd squidy
+
+# 2. Crie e ative um ambiente virtual (recomendado)
+python3 -m venv venv
+source venv/bin/activate        # Linux / macOS
+# venv\Scripts\activate         # Windows
+
+# 3. Instale as dependências
+pip install -r requirements.txt
+
+# 4. Execute
+python3 -m squidy
+```
+
+## 🎮 Como usar (2 minutos)
+
+```
+$ python3 -m squidy
+
+  1  🦑 Nova instalação com IA
+  2  📝 Instalação manual (offline)
+
+  › 1
+
+  🔑 Informe a API key (não aparece na tela)...
+  ✓ Conectado ao OpenAI
+
+  🤖 Agente: Me conte sobre o projeto.
+     Você: API REST para delivery com Node e PostgreSQL
+
+  🤖 Agente: Qual método de autenticação?
+     Você: JWT
+
+  Caminho do projeto: /home/user/meu-projeto
+
+  🦑 9 arquivos gerados em /home/user/meu-projeto
+```
+
+**Abra `seu-projeto/doc/AGENT.md` e cole no Claude.**
+Ele entenderá o contexto completo antes de escrever uma linha de código.
+
+## ✨ Por que devs usam o Squidy?
+
+| Sem Squidy | Com Squidy |
+|------------|------------|
+| IA esquece o projeto na próxima sessão | ✅ Contexto preservado entre conversas |
+| Agente propõe soluções fora do escopo | ✅ Regras claras (o que pode/não pode fazer) |
+| Você repete os mesmos requisitos | ✅ Documentação gerada automaticamente |
+| Código sem padrão | ✅ Stack definida, convenções estabelecidas |
+| Perde 30 min no setup | ✅ Pronto em 2 minutos |
+
+## 🏗️ O que ele cria?
+
+O Squidy gera uma estrutura de governança completa que obriga seu agente de IA a:
+
+- 📖 **Ler o contexto** antes de qualquer ação (nunca mais esquece)
+- 🚫 **Respeitar proibições** (ex: "Nunca use mock em produção")
+- ✅ **Seguir Definition of Done** (critérios objetivos de pronto)
+- 📝 **Documentar no diário** cada ação (rastreabilidade total)
+
+**Os 9 arquivos gerados:**
+
+```
+seu-projeto/
+├── diario/                  # 📅 Log automático de decisões
+└── doc/
+    ├── AGENT.md             # 🎯 Cole isso no Claude para começar
+    ├── constituicao.md      # ⚖️  Regras imutáveis (o que NUNCA fazer)
+    ├── oraculo.md           # 🧙 Decisões de arquitetura (ADRs)
+    ├── politicas.md         # 📋 Stack tecnológica e convenções
+    ├── kanban.md            # 📊 Gestão de tarefas (To Do → Done)
+    ├── emergencia.md        # 🚨 Registro de bloqueios críticos
+    ├── indice-diario.md     # 📑 Índice do histórico
+    └── contexto-sessao.md   # 💾 Cache do estado atual
+```
+
+## 🔒 Segurança em primeiro lugar
+
+- ✅ API keys são **inputadas com `getpass`** (não aparecem na tela)
+- ✅ **Nunca salvas em disco** (apenas memória RAM)
+- ✅ **Memória limpa automaticamente** após uso
+- ✅ Modo **offline disponível** (funciona sem API key)
+
+## 💻 Para quem é?
+
+- 👨‍💻 **Devs que usam Claude/Cursor/GitHub Copilot** diariamente
+- 🏗️ **Arquitetos** que precisam manter padrão em projetos complexos
+- 🚀 **Vibe coders** que querem começar a codar em 2 minutos, não em 30
+- 📚 **Equipes** que precisam de rastreabilidade de decisões de IA
+
+## 🛠️ Desenvolvimento
+
+```bash
+git clone https://github.com/seomarc/squidy.git
+cd squidy
+python3 -m venv venv && source venv/bin/activate
+pip install -r requirements.txt
+
+# Rodar
+python3 -m squidy
+
+# Rodar testes de smoke
+python3 run_tests.py
+```
+
+## 🤝 Contribuir
+
+Issues e PRs são bem-vindos! Leia [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## 📄 Licença
+
+MIT License - livre para usar, modificar e distribuir.
+
+---
+
+**Feito com 🦑 para devs que cansaram de perder contexto com IA**
+# squidy

squidy-1.0.0/README.md

@@ -0,0 +1,163 @@
+# 🦑 Squidy - Setup Inteligente para Projetos com Agentes de IA
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/seomarc/squidy)
+[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://python.org)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+**Pare de perder contexto com seu Agente de IA. Configure projetos profissionais em 2 minutos.**
+
+[Instalação](#instalação) • [Como funciona](#como-funciona) • [Documentação](https://squidy.run) • [Contribuir](#contribuir)
+
+</div>
+
+## 😤 O Problema que Resolvemos
+
+Você usa **Claude**, **ChatGPT** ou **Cursor** para programar, mas:
+
+- 🤯 **A IA esquece tudo** na próxima conversa (perda de contexto)
+- 📝 **Você reescreve** os mesmos requisitos toda semana
+- 🎨 **O agente fica "criativo"** e muda sua arquitetura sem avisar
+- 📂 **Seu projeto vira bagunça** porque ninguém documenta nada
+- ⏱️ **Gasta 30 min** configurando prompt antes de começar a codar
+
+**O Squidy resolve isso em 2 minutos.**
+
+## 🎯 O que é o Squidy?
+
+O **Squidy** é um **instalador CLI** que cria automaticamente a estrutura de governança para seus projetos com Agentes de IA (Claude, GPT-4, Cursor, etc).
+
+Em vez de você digitar 20 mensagens explicando seu projeto toda vez que abre o chat, o Squidy:
+
+1. 🎤 **Entrevista você** com 5 perguntas inteligentes
+2. 🧠 **Usa IA** para entender seu stack e regras
+3. 📋 **Gera 9 arquivos de documentação** que seu agente DEVE ler antes de começar
+4. 🔒 **Cria um "contrato"** entre você e a IA: regras, proibições, definição de pronto
+
+**Resultado:** Sua IA nunca mais perde o contexto ou sai do escopo.
+
+## 🚀 Instalação
+
+> **Nota:** o Squidy ainda não está no PyPI. Use o método clone abaixo.
+
+```bash
+# 1. Clone o repositório
+git clone https://github.com/seomarc/squidy.git
+cd squidy
+
+# 2. Crie e ative um ambiente virtual (recomendado)
+python3 -m venv venv
+source venv/bin/activate        # Linux / macOS
+# venv\Scripts\activate         # Windows
+
+# 3. Instale as dependências
+pip install -r requirements.txt
+
+# 4. Execute
+python3 -m squidy
+```
+
+## 🎮 Como usar (2 minutos)
+
+```
+$ python3 -m squidy
+
+  1  🦑 Nova instalação com IA
+  2  📝 Instalação manual (offline)
+
+  › 1
+
+  🔑 Informe a API key (não aparece na tela)...
+  ✓ Conectado ao OpenAI
+
+  🤖 Agente: Me conte sobre o projeto.
+     Você: API REST para delivery com Node e PostgreSQL
+
+  🤖 Agente: Qual método de autenticação?
+     Você: JWT
+
+  Caminho do projeto: /home/user/meu-projeto
+
+  🦑 9 arquivos gerados em /home/user/meu-projeto
+```
+
+**Abra `seu-projeto/doc/AGENT.md` e cole no Claude.**
+Ele entenderá o contexto completo antes de escrever uma linha de código.
+
+## ✨ Por que devs usam o Squidy?
+
+| Sem Squidy | Com Squidy |
+|------------|------------|
+| IA esquece o projeto na próxima sessão | ✅ Contexto preservado entre conversas |
+| Agente propõe soluções fora do escopo | ✅ Regras claras (o que pode/não pode fazer) |
+| Você repete os mesmos requisitos | ✅ Documentação gerada automaticamente |
+| Código sem padrão | ✅ Stack definida, convenções estabelecidas |
+| Perde 30 min no setup | ✅ Pronto em 2 minutos |
+
+## 🏗️ O que ele cria?
+
+O Squidy gera uma estrutura de governança completa que obriga seu agente de IA a:
+
+- 📖 **Ler o contexto** antes de qualquer ação (nunca mais esquece)
+- 🚫 **Respeitar proibições** (ex: "Nunca use mock em produção")
+- ✅ **Seguir Definition of Done** (critérios objetivos de pronto)
+- 📝 **Documentar no diário** cada ação (rastreabilidade total)
+
+**Os 9 arquivos gerados:**
+
+```
+seu-projeto/
+├── diario/                  # 📅 Log automático de decisões
+└── doc/
+    ├── AGENT.md             # 🎯 Cole isso no Claude para começar
+    ├── constituicao.md      # ⚖️  Regras imutáveis (o que NUNCA fazer)
+    ├── oraculo.md           # 🧙 Decisões de arquitetura (ADRs)
+    ├── politicas.md         # 📋 Stack tecnológica e convenções
+    ├── kanban.md            # 📊 Gestão de tarefas (To Do → Done)
+    ├── emergencia.md        # 🚨 Registro de bloqueios críticos
+    ├── indice-diario.md     # 📑 Índice do histórico
+    └── contexto-sessao.md   # 💾 Cache do estado atual
+```
+
+## 🔒 Segurança em primeiro lugar
+
+- ✅ API keys são **inputadas com `getpass`** (não aparecem na tela)
+- ✅ **Nunca salvas em disco** (apenas memória RAM)
+- ✅ **Memória limpa automaticamente** após uso
+- ✅ Modo **offline disponível** (funciona sem API key)
+
+## 💻 Para quem é?
+
+- 👨‍💻 **Devs que usam Claude/Cursor/GitHub Copilot** diariamente
+- 🏗️ **Arquitetos** que precisam manter padrão em projetos complexos
+- 🚀 **Vibe coders** que querem começar a codar em 2 minutos, não em 30
+- 📚 **Equipes** que precisam de rastreabilidade de decisões de IA
+
+## 🛠️ Desenvolvimento
+
+```bash
+git clone https://github.com/seomarc/squidy.git
+cd squidy
+python3 -m venv venv && source venv/bin/activate
+pip install -r requirements.txt
+
+# Rodar
+python3 -m squidy
+
+# Rodar testes de smoke
+python3 run_tests.py
+```
+
+## 🤝 Contribuir
+
+Issues e PRs são bem-vindos! Leia [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## 📄 Licença
+
+MIT License - livre para usar, modificar e distribuir.
+
+---
+
+**Feito com 🦑 para devs que cansaram de perder contexto com IA**
+# squidy

squidy-1.0.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "squidy"
+version = "1.0.0"
+description = "Setup inteligente para projetos com Agentes de IA"
+readme = "README.md"
+license = "MIT"
+authors = [{name = "Squidy", email = "contato@squidy.run"}]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Build Tools",
+    "Programming Language :: Python :: 3",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "rich>=13.7.0",
+    "requests>=2.31.0",
+    "openai>=1.10.0",
+    "anthropic>=0.18.0",
+    "jinja2>=3.1.3",
+    "cryptography>=42.0.0",
+]
+
+[project.scripts]
+squidy = "squidy.main:main"
+
+[project.urls]
+Homepage = "https://squidy.run"
+Repository = "https://github.com/seomarc/squidy"
+Changelog = "https://github.com/seomarc/squidy/blob/main/CHANGELOG.md"

squidy-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

squidy-1.0.0/setup.py

@@ -0,0 +1,42 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="squidy",
+    version="1.0.0",
+    author="Squidy",
+    author_email="contato@squidy.run",
+    description="Setup inteligente para projetos com Agentes de IA",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/seomarc/squidy",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Topic :: Software Development :: Build Tools",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    python_requires=">=3.8",
+    install_requires=[
+        "rich>=13.7.0",
+        "requests>=2.31.0",
+        "openai>=1.10.0",
+        "anthropic>=0.18.0",
+        "jinja2>=3.1.3",
+        "cryptography>=42.0.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "squidy=squidy.main:main",
+        ],
+    },
+)

squidy-1.0.0/squidy/__init__.py

@@ -0,0 +1,6 @@
+"""
+Squidy Setup with AI Agent - Automated framework installer
+"""
+
+__version__ = "1.0.0"
+__author__ = "Squidy Framework"

squidy-1.0.0/squidy/__main__.py

@@ -0,0 +1,7 @@
+"""
+Entry point for `python3 -m squidy`
+"""
+from squidy.main import main
+
+if __name__ == "__main__":
+    main()

squidy-1.0.0/squidy/agents/__init__.py

@@ -0,0 +1,9 @@
+"""
+Agents module - Interview and configuration logic
+"""
+
+from .configurator import ConfiguratorAgent
+from .file_generator import SquidyFileGenerator
+
+__version__ = "1.0.0"
+__all__ = ["ConfiguratorAgent", "SquidyFileGenerator"]