Select Language / Selecione o Idioma:
FrameCode VibeWork é um framework de governança documental e técnica para desenvolvimento de aplicações assistido por IA. Ele reduz perda de contexto entre sessões ao combinar planos formais, changelogs, auditorias, troubleshooting, decisões arquiteturais, snippets reutilizáveis e uma LLM Wiki mantida em Markdown.
O framework usa um ciclo de vida explícito para garantir que mudanças sejam justificadas, planejadas, implementadas, validadas e registradas.
graph TD
A["Fase 0: Briefing"] -->|"Definição de escopo"| B["Manifesto e Escopo"]
B -->|"Solicitação de mudança"| C["Plano de alteração"]
C -->|"Execução assistida por IA"| D["Implementação"]
D -->|"Rastreabilidade"| E["Changelog e versionamento"]
E -->|"Validação"| F["Auditoria e release"]
F -->|"Aprendizado"| G["Wiki / memória técnica"]
G -->|"Contexto acumulado"| C
Nenhuma alteração funcional, visual, estrutural ou documental deve ser aplicada sem plano correspondente em Plans/.
Toda alteração em arquivo versionado deve ser registrada em changelogs/Vx.y.z.md, com plano relacionado, arquivos afetados, validação e riscos residuais.
A pasta wiki/ segue o padrão LLM Wiki: fontes brutas, páginas sintetizadas, índice, log, links internos, estados de confiança e lint periódico.
Portabilidade e Reuso: O conhecimento acumulado na
wiki/(padrões, decisões, troubleshooting) pode e deve ser portado e reutilizado em novos projetos para acelerar o desenvolvimento assistido por IA e manter a consistência técnica entre diferentes aplicações.
A pasta snippets/ guarda componentes e padrões prontos para adaptação, com galeria visual e tokens CSS.
A pasta governance/ preserva templates genéricos. Os documentos preenchidos do projeto ficam na raiz. A instanciação e as regras de renomeação estão em INSTANTIATION.md.
📁 .
├── 📄 AGENTS.md
├── 📄 MANIFEST.md
├── 📄 README.md
├── 📄 INSTANTIATION.md
├── 📄 SCOPE.md
├── 📄 STACK.md
├── 📄 DESIGN.md
├── 📄 WORKFLOW.md
├── 📄 PLANNING.md
├── 📄 VERSIONING.md
├── 📄 TROUBLESHOOTING.md
├── 📄 TESTS.md
├── 📄 SECURITY.md
├── 📄 DATA.md
├── 📄 AI.md
├── 📄 REFACTORING.md
├── 📄 RELEASE.md
├── 📄 AUDIT.md
├── 📄 ARCHITECTURAL_DECISIONS.md
├── 📄 FILESYSTEM.md
├── 📂 Plans/
│ ├── 📂 pending/
│ ├── 📂 in_progress/
│ ├── 📂 completed/
│ └── 📂 discontinued/
├── 📂 changelogs/
├── 📂 troubleshooting/
├── 📂 decisions/
├── 📂 audits/
├── 📂 briefings/
├── 📂 wiki/
│ ├── 📄 schema.md
│ ├── 📄 index.md
│ ├── 📄 log.md
│ ├── 📂 templates/
│ └── 📂 sessions/
├── 📂 skills/
│ ├── 📄 README.md
│ └── 📂 obsidian-markdown/
│ └── 📄 SKILL.md
├── 📂 snippets/
└── 📂 governance/
Plans/: ciclo de vida das alterações.changelogs/: histórico formal por versão.troubleshooting/: registros de falhas, hipóteses e validações.decisions/: ADRs formais.audits/: relatórios de auditoria.briefings/: registros de descoberta e Fase 0.wiki/: memória técnica compatível com Obsidian.skills/: catálogo de habilidades executáveis do agente de IA.snippets/: biblioteca de componentes e padrões reutilizáveis.governance/: templates genéricos do framework.
Para maximizar a transparência de custos de chamadas de APIs de LLMs, o framework mapeia o consumo de tokens estimado para cada cenário de desenvolvimento com base em suas políticas ativas:
| Cenário Mapeado | Documentos Ingeridos | Custo Inicial (Sem AICC) | Custo por Turno com AICC | Economia com AICC |
|---|---|---|---|---|
| Bugfix / Troubleshooting | AGENTS.md + TROUBLESHOOTING.md + PLANNING.md |
~5.000 tokens | ~1.200 tokens | -76% |
| Nova Funcionalidade | AGENTS.md + SCOPE.md + PLANNING.md + DESIGN.md |
~7.000 tokens | ~1.500 tokens | -78% |
| Componentes / UI | AGENTS.md + DESIGN.md + snippets/README.md |
~4.500 tokens | ~1.000 tokens | -77% |
| Refatoração | AGENTS.md + REFACTORING.md + PLANNING.md |
~8.000 tokens | ~1.800 tokens | -77% |
| Briefing / Instanciação | AGENTS.md + INSTANTIATION.md + BRIEFING.md + MANIFEST.md |
~8.500 tokens | ~2.000 tokens | -76% |
Nota: As estimativas consideram o tamanho médio atual dos arquivos de governança do framework. 1 token ≈ 4 caracteres em inglês ou ~3 caracteres em português.
Use este repositório como base para um novo projeto ou mantenha-o como framework central.
git clone https://github.com/Sistema2D/FrameCode-VibeWork.git meu-projeto
cd meu-projetoLeia AGENTS.md e INSTANTIATION.md. A instanciação não depende de script automático: renomeações e substituições devem ser feitas explicitamente, preservando templates em governance/ e wiki/templates/.
Preencha BRIEFING.md, atualize MANIFEST.md, STACK.md, SCOPE.md e README.md, e registre a alteração por plano e changelog.
Ao solicitar mudanças, peça para o agente seguir AGENTS.md. Para consultas, análise e revisão sem edição de arquivos, plano não é obrigatório. Para qualquer alteração, o fluxo de plano e changelog é obrigatório.
FrameCode VibeWork is a technical and document-based governance framework for AI-assisted application development. It reduces context loss between sessions by combining formal plans, changelogs, audits, troubleshooting, architectural decisions, reusable snippets, and an LLM Wiki maintained in Markdown.
The framework uses an explicit lifecycle to ensure that changes are justified, planned, implemented, validated, and recorded.
graph TD
A["Phase 0: Briefing"] -->|"Scope definition"| B["Manifest and Scope"]
B -->|"Change request"| C["Change plan"]
C -->|"AI-assisted execution"| D["Implementation"]
D -->|"Traceability"| E["Changelog and versioning"]
E -->|"Validation"| F["Audit and release"]
F -->|"Learning"| G["Wiki / technical memory"]
G -->|"Accumulated context"| C
No functional, visual, structural, or document change should be applied without a corresponding plan in Plans/.
Every change in a versioned file must be recorded in changelogs/Vx.y.z.md, with related plans, affected files, validation, and residual risks.
The wiki/ folder follows the LLM Wiki standard: raw sources, synthesized pages, index, log, internal links, confidence states, and periodic linting.
Portability and Reuse: The knowledge accumulated in the
wiki/(patterns, decisions, troubleshooting) can and should be ported and reused in new projects to accelerate AI-assisted development and maintain technical consistency across different applications.
The snippets/ folder holds components and patterns ready for adaptation, with a visual gallery and CSS tokens.
The governance/ folder preserves generic templates. Filled project documents reside at the root. Instantiation and renaming rules are in INSTANTIATION.md.
📁 .
├── 📄 AGENTS.md
├── 📄 MANIFEST.md
├── 📄 README.md
├── 📄 INSTANTIATION.md
├── 📄 SCOPE.md
├── 📄 STACK.md
├── 📄 DESIGN.md
├── 📄 WORKFLOW.md
├── 📄 PLANNING.md
├── 📄 VERSIONING.md
├── 📄 TROUBLESHOOTING.md
├── 📄 TESTS.md
├── 📄 SECURITY.md
├── 📄 DATA.md
├── 📄 AI.md
├── 📄 REFACTORING.md
├── 📄 RELEASE.md
├── 📄 AUDIT.md
├── 📄 ARCHITECTURAL_DECISIONS.md
├── 📄 FILESYSTEM.md
├── 📂 Plans/
│ ├── 📂 pending/
│ ├── 📂 in_progress/
│ ├── 📂 completed/
│ └── 📂 discontinued/
├── 📂 changelogs/
├── 📂 troubleshooting/
├── 📂 decisions/
├── 📂 audits/
├── 📂 briefings/
├── 📂 wiki/
│ ├── 📄 schema.md
│ ├── 📄 index.md
│ ├── 📄 log.md
│ ├── 📂 templates/
│ └── 📂 sessions/
├── 📂 skills/
│ ├── 📄 README.md
│ └── 📂 obsidian-markdown/
│ └── 📄 SKILL.md
├── 📂 snippets/
└── 📂 governance/
Plans/: lifecycle of changes.changelogs/: formal version history.troubleshooting/: records of failures, hypotheses, and validations.decisions/: formal ADRs.audits/: audit reports.briefings/: discovery and Phase 0 records.wiki/: Obsidian-compatible technical memory.skills/: catalog of executable AI agent skills.snippets/: library of reusable components and patterns.governance/: generic templates of the framework.
To maximize transparency and API call cost-efficiency with LLMs, the framework maps the estimated token consumption for each development scenario based on its active policies:
| Mapped Scenario | Ingested Documents | Initial Load (No AICC) | Continuous Turn Cost (With AICC) | Savings with AICC |
|---|---|---|---|---|
| Bugfix / Troubleshooting | AGENTS.md + TROUBLESHOOTING.md + PLANNING.md |
~5,000 tokens | ~1,200 tokens | -76% |
| New Feature | AGENTS.md + SCOPE.md + PLANNING.md + DESIGN.md |
~7,000 tokens | ~1,500 tokens | -78% |
| Componentes / UI | AGENTS.md + DESIGN.md + snippets/README.md |
~4,500 tokens | ~1,000 tokens | -77% |
| Refactoring | AGENTS.md + REFACTORING.md + PLANNING.md |
~8,000 tokens | ~1,800 tokens | -77% |
| Briefing / Instantiation | AGENTS.md + INSTANTIATION.md + BRIEFING.md + MANIFEST.md |
~8,500 tokens | ~2,000 tokens | -76% |
Note: Estimates are based on the current average size of the framework's governance files. 1 token ≈ 4 characters in English or ~3 characters in Portuguese.
Use this repository as a base for a new project or keep it as a central framework.
git clone https://github.com/Sistema2D/FrameCode-VibeWork.git my-project
cd my-projectRead AGENTS.md and INSTANTIATION.md. Instantiation does not rely on automatic scripts: renaming and replacements must be done explicitly, preserving templates in governance/ and wiki/templates/.
Fill out BRIEFING.md, update MANIFEST.md, STACK.md, SCOPE.md, and README.md, and record the change via plan and changelog.
When requesting changes, ask the agent to follow AGENTS.md. For queries, analysis, and reviews without file editing, a plan is not mandatory. For any modification, the plan and changelog workflow is mandatory.
Abra a pasta raiz como um vault no Obsidian para visualizar links entre decisões, falhas, padrões, auditorias, releases e sínteses da wiki. / Open the root folder as a vault in Obsidian to visualize links between decisions, failures, patterns, audits, releases, and wiki syntheses.
O conceito de LLM Wiki usado como inspiração para a memória técnica incremental deste framework é creditado a Andrej Karpathy, autor do gist LLM Wiki. / The LLM Wiki concept used as inspiration for the incremental technical memory of this framework is credited to Andrej Karpathy, author of the LLM Wiki gist.
Se este framework for útil para o seu trabalho, você pode apoiar o desenvolvimento pelo Buy Me a Coffee: / If this framework is useful for your work, you can support development via Buy Me a Coffee:
Este projeto está licenciado sob a licença MIT. Veja LICENSE. / This project is licensed under the MIT license. See LICENSE.