{"_id":"@delmar-filho/idk","_rev":"2-948fce3b8f5b32065a8ca4360c670925","name":"@delmar-filho/idk","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@delmar-filho/idk","version":"1.0.0","keywords":["AI","agents","SDD","framework"],"author":{"name":"Delmar Filho"},"license":"MIT","_id":"@delmar-filho/idk@1.0.0","maintainers":[{"name":"delmar-filho","email":"ddlmar13@gmail.com"}],"bin":{"idk":"dist/main.js"},"dist":{"shasum":"cac729b5e3fb00792999cf09e70bdada69bbea6b","tarball":"https://registry.npmjs.org/@delmar-filho/idk/-/idk-1.0.0.tgz","fileCount":77,"integrity":"sha512-oKtRZf3DeKY9ktSBYZGR2YuKiri7beK3Z2hR87htEa9JbE658nFLiVAeiZmNZkDs44htWKf4YAZhjyUAwbDiTw==","signatures":[{"sig":"MEYCIQDCTbZ5R0divLSEIh0RtWzzpLe5IrLCiBrIH3ETAUSheQIhAN3gWc5HGnRGmp5JR4QK8ytRacFH4HBO8cR9O828irf0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103664},"main":"dist/main.js","type":"module","types":"./dist/main.d.ts","gitHead":"3f12c1a98ef69804bc0cd1e0ddfbab1d3e9f8ecf","scripts":{"dev":"tsx src/main.ts","lint":"eslint .","prod":"node dist/main.js","test":"tsx --test tests/setup.test.ts","build":"tsc && node -e \"fs.cpSync('src/files', 'dist/files', { recursive: true }); fs.copyFileSync('src/release-note.json', 'dist/release-note.json')\"","setup":"lefthook install","format":"prettier --write .","lint:fix":"eslint . --fix","typecheck":"tsc --noEmit","format:check":"prettier --check .","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"delmar-filho","email":"ddlmar13@gmail.com"},"_npmVersion":"10.8.2","description":"basic framework to work with AI agents","directories":{},"_nodeVersion":"20.20.2","dependencies":{"figlet":"^1.11.4","picocolors":"^1.1.1","@clack/prompts":"^1.7.0","gradient-string":"^3.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.12","eslint":"^10.7.0","globals":"^17.11.0","lefthook":"^2.1.10","prettier":"^3.9.6","@eslint/js":"^10.0.1","typescript":"^5.7.3","@types/node":"^26.2.0","@types/figlet":"^1.7.0","typescript-eslint":"^8.65.0","eslint-config-prettier":"^10.1.8"},"_npmOperationalInternal":{"tmp":"tmp/idk_1.0.0_1787185243568_0.9627462682458008","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@delmar-filho/idk","version":"1.0.1","description":"basic framework to work with AI agents","main":"dist/main.js","bin":{"idk":"dist/main.js"},"publishConfig":{"access":"public"},"type":"module","scripts":{"dev":"tsx src/main.ts","build":"tsc && node -e \"fs.cpSync('src/files', 'dist/files', { recursive: true }); fs.copyFileSync('src/release-note.json', 'dist/release-note.json')\"","prepublishOnly":"pnpm run build","prod":"node dist/main.js","setup":"lefthook install","test":"tsx --test tests/setup.test.ts","format":"prettier --write .","format:check":"prettier --check .","lint":"eslint .","lint:fix":"eslint . --fix","typecheck":"tsc --noEmit"},"keywords":["AI","agents","SDD","framework"],"author":{"name":"Delmar Filho"},"license":"MIT","dependencies":{"@clack/prompts":"^1.7.0","figlet":"^1.11.4","gradient-string":"^3.0.0","picocolors":"^1.1.1"},"devDependencies":{"@eslint/js":"^10.0.1","@types/figlet":"^1.7.0","@types/node":"^26.2.0","eslint":"^10.7.0","eslint-config-prettier":"^10.1.8","globals":"^17.11.0","lefthook":"^2.1.10","prettier":"^3.9.6","tsx":"^4.23.12","typescript":"^5.7.3","typescript-eslint":"^8.65.0"},"_id":"@delmar-filho/idk@1.0.1","gitHead":"8342888505953f5c528b10af86cff7c4bcff13d8","types":"./dist/main.d.ts","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-qrHfWlqg6AjoMGMl3sL9X314JWDykvoPF9KnSiHK+gGzy7uBXp6xo538Qm8lj8shnlnTni95d3/l1SF/3KF1lQ==","shasum":"423d2d5f3f6a4dafbf0cf382ec89bc82f5eb9128","tarball":"https://registry.npmjs.org/@delmar-filho/idk/-/idk-1.0.1.tgz","fileCount":77,"unpackedSize":103970,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDPWhya/y0BOVk9llQ35MMIMZmpIdLjZUtyDmLOPDDOgAiEA3zTIZ29BaHUde6fY5tLF2urRNmczNukMbzPceVjO/20="}]},"_npmUser":{"name":"delmar-filho","email":"ddlmar13@gmail.com"},"directories":{},"maintainers":[{"name":"delmar-filho","email":"ddlmar13@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/idk_1.0.1_1787185685965_0.921039545172855"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-20T00:20:43.395Z","modified":"2026-08-20T00:28:06.280Z","1.0.0":"2026-08-20T00:20:43.748Z","1.0.1":"2026-08-20T00:28:06.127Z"},"author":{"name":"Delmar Filho"},"license":"MIT","keywords":["AI","agents","SDD","framework"],"description":"basic framework to work with AI agents","maintainers":[{"name":"delmar-filho","email":"ddlmar13@gmail.com"}],"readme":"# IDK SDD Framework CLI 🚀\n\n**IDK** é um mini-framework projetado para padronizar e acelerar o desenvolvimento orientado a especificações (**Spec-Driven Development - SDD**) com assistentes de inteligência artificial (como Antigravity, Claude Desktop, Cursor e outros).\n\n---\n\n## 📦 Como Executar a CLI\n\nVocê pode executar o IDK diretamente no seu terminal sem necessidade de instalação prévia, utilizando seu gerenciador de pacotes favorito:\n\n### Usando `npx` (npm)\n\n```bash\nnpx @delmar-filho/idk\n```\n\n### Usando `pnpm dlx`\n\n```bash\npnpm dlx @delmar-filho/idk\n```\n\n### Usando `yarn dlx`\n\n```bash\nyarn dlx @delmar-filho/idk\n```\n\n### Usando `bunx`\n\n```bash\nbunx @delmar-filho/idk\n```\n\n---\n\n## ⚡ Recursos Principais\n\n- **Visualizador de Release Notes**: Consulte o histórico de notas de lançamento e mudanças por versão diretamente pela CLI ou via flag:\n  ```bash\n  npx @delmar-filho/idk --release-notes\n  ```\n- **Suporte Multi-Harness**: Configuração automatizada para Google Antigravity, Claude Desktop e Cursor.\n- **Estrutura `.specify/`**: Gestão padronizada de especificações, planejamentos (`plans/`) e convenções do repositório (`project-pattern/`).\n- **Configuração Customizável (`config.json`)**: Ajuste de nível de conversação da IA, regras de branch e `postExecution.hooks` para qualidade de código.\n\n---\n\n## 🛠️ Como Usar no Seu Projeto (Fluxo SDD)\n\nApós rodar `npx @delmar-filho/idk` no seu repositório e selecionar o harness desejado:\n\n1. **Boas-vindas & Onboarding**: Invoque a skill `/idk-welcome` no seu assistente de IA.\n2. **Mapeamento de Padrões**: Execute `/idk-scan-code-pattern` para registrar a arquitetura do projeto em `.specify/project-pattern/`.\n3. **Planejamento de Tarefas**: Solicite `/idk-task-planning <descrição da tarefa>` para criar uma especificação em `.specify/plans/`.\n4. **Execução Automatizada**: Invoque `/idk-task-execution` para o assistente implementar o código e rodar os hooks pós-execução configurados em `config.json`.\n5. **Commit Atômico**: Utilize `/idk-atomic-commit` para validar branches e commitar com mensagens padronizadas.\n\n---\n\n## ⚙️ Arquivo `.specify/config.json`\n\nO arquivo `[config.json](.specify/config.json)` controla o comportamento das automações no projeto:\n\n```json\n{\n  \"conversationLevel\": \"medium\",\n  \"plans\": {\n    \"current\": \"001_setup_inicial\",\n    \"status\": \"completed\",\n    \"path\": \".specify/plans/001_setup_inicial.md\"\n  },\n  \"postExecution\": {\n    \"hooks\": [\"pnpm format\", \"pnpm lint\", \"pnpm build\"]\n  },\n  \"rules\": {\n    \"branch\": {\n      \"protected\": [\"main\", \"master\"]\n    }\n  }\n}\n```\n\n---\n\n## 📄 Licença\n\nDistribuído sob a licença MIT.\n","readmeFilename":"README.md"}