{
  "markdown": "# D&D Combat Simulator\n\nProjeto Rails para modelar personagens de Dungeons & Dragons 5e e simular combates entre equipes, com foco em avaliar dificuldade prática de encounters por meio de execuções repetidas, logs e métricas de resultado.\n\n## Objetivo\n\nO objetivo principal deste repositório não é apenas cadastrar personagens ou classes, mas evoluir um simulador de combate que permita responder perguntas como:\n- qual a taxa de vitória de uma composição contra outra;\n- quantas rodadas um encontro costuma durar;\n- que mecânicas alteram mais o resultado agregado de um combate.\n\n## Stack\n\n- Ruby on Rails 8\n- ERB + Bootstrap para UI\n- SQLite no desenvolvimento, com suporte a PostgreSQL\n\n## Estado atual da arquitetura\n\n- `EncounterService` sustenta o fluxo de combate atual e deve ser tratado como implementação provisória e congelada fora de refatorações explícitas.\n- O caminho de evolução do combate está no pipeline `Combat::*`, que introduz ações, resolução de efeitos e execução estruturada.\n- A documentação arquitetural descreve tanto o comportamento atual quanto a direção incremental de refatoração.\n\nPontos de entrada recomendados:\n- [.okf/index.md](.okf/index.md)\n- [.okf/architecture/overview.md](.okf/architecture/overview.md)\n- [.okf/architecture/encounter-service.md](.okf/architecture/encounter-service.md)\n- [.okf/architecture/combat-effect-pipeline.md](.okf/architecture/combat-effect-pipeline.md)\n\n## Setup rápido\n\n```bash\nbundle install\nyarn install\nbin/rails db:create db:migrate\n./bin/dev\n```\n\n## Rodando testes\n\n```bash\nbin/rails test\n```\n\nPara focar em uma área específica:\n\n```bash\nbin/rails test test/models\nbin/rails test test/services\nbin/rails test test/integration\n```\n\n## Navegação rápida por intenção\n\nSe você quer:\n\n- entender a arquitetura geral: [.okf/architecture/overview.md](.okf/architecture/overview.md)\n- entender o combate atual: [.okf/architecture/encounter-service.md](.okf/architecture/encounter-service.md)\n- trabalhar no pipeline novo de habilidades e efeitos: [.okf/architecture/combat-effect-pipeline.md](.okf/architecture/combat-effect-pipeline.md)\n- entender os modelos e persistência: [.okf/models/index.md](.okf/models/index.md)\n- entender a modelagem de habilidades: [.okf/models/class-feature.md](.okf/models/class-feature.md)\n- seguir instruções para agentes de IA: [.instructions.md](.instructions.md)\n\n## Restrições importantes\n\n- Não expanda `EncounterService` fora de uma refatoração explícita do sistema de combate.\n- Prefira o pipeline `Combat::*` para novas mecânicas executáveis.\n- Ao alterar regras de combate, valide comportamento mecânico e não apenas estrutura de código.\n\n## Status da documentação\n\nO diretório [docs](docs) concentra a documentação oficial do projeto.\n\nO diretório [tmp](tmp) pode conter checkpoints de trabalho e notas de pesquisa usadas durante sessões com IA. Esses arquivos não devem ser tratados automaticamente como documentação oficial do sistema.\n",
  "bytes": 2945,
  "sha": "9a43b96f0646c1ad82adbffd732c92964404b8a80bc271409238d0ba99d67ac4",
  "repo_slug": "lsolagc/dnd5ecombatsimulator",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_lsolagc_dnd5ecombatsimulator_okf_index_m_95d48fd3/readme"
}