{"_id":"@aurumsoltec/aurumcortex","name":"@aurumsoltec/aurumcortex","dist-tags":{"latest":"0.1.0-preview.1"},"versions":{"0.1.0-preview.1":{"name":"@aurumsoltec/aurumcortex","version":"0.1.0-preview.1","description":"CLI local para orquestração de agentes, documentação viva, backlog técnico e desenvolvimento assistido.","type":"module","author":{"name":"AurumSolTec"},"homepage":"https://github.com/aurumsoltec/AurumCortex#readme","repository":{"type":"git","url":"git+https://github.com/aurumsoltec/AurumCortex.git"},"bugs":{"url":"https://github.com/aurumsoltec/AurumCortex/issues"},"keywords":["ai","agents","cli","developer-tools","opencode","workflow","backlog","architecture","automation","orchestration","aurumcortex"],"os":["darwin","linux","win32"],"bin":{"aurumcortex":"dist/cli/index.js","aurum-cortex":"dist/cli/index.js","acx":"dist/cli/index.js","aurumcortex-install":"install.js"},"publishConfig":{"access":"public"},"scripts":{"dev":"tsx src/cli/index.ts","build":"tsc","start":"node dist/cli/index.js","typecheck":"tsc --noEmit","pretest":"npm run build","test":"node --test","postinstall":"node postinstall.js","pack:dry-run":"npm pack --dry-run","validate:publish":"npm run typecheck && npm run build && npm test && node scripts/validate-publish.mjs","prepublishOnly":"npm run validate:publish"},"dependencies":{"commander":"^12.1.0","execa":"^9.3.1","picocolors":"^1.1.1"},"devDependencies":{"@types/node":"^20.19.41","tsx":"^4.16.2","typescript":"^5.9.3"},"engines":{"node":">=20.0.0"},"license":"UNLICENSED","_id":"@aurumsoltec/aurumcortex@0.1.0-preview.1","gitHead":"bc6c8172a361d989bdac9d86ac9ba05ab3d5913c","_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-5Kk9WQLYDzWr7OHQY/LQqJx1z/RbLhw9AsFi/uMIyn9Al+NN3qZyAJ7eDHR/58PqW3d68i9bK30kPqU47rhNnw==","shasum":"083ed609a3da320b143a472e904eec49112966d5","tarball":"https://registry.npmjs.org/@aurumsoltec/aurumcortex/-/aurumcortex-0.1.0-preview.1.tgz","fileCount":73,"unpackedSize":247070,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCOWsU+cIfqK1D4Kj2xPqcwRKVS2Uc20qIEpjCaHr6FsQIgWmSWlXP85EoWzaMRTB9/7EQuchLt2x3WHqzSuOLeWjU="}]},"_npmUser":{"name":"aurumsoltec","email":"fernandolima9516@gmail.com"},"directories":{},"maintainers":[{"name":"aurumsoltec","email":"fernandolima9516@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aurumcortex_0.1.0-preview.1_1782583463184_0.7369581223102253"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-27T18:04:23.066Z","0.1.0-preview.1":"2026-06-27T18:04:23.339Z","modified":"2026-06-27T18:04:23.551Z"},"maintainers":[{"name":"aurumsoltec","email":"fernandolima9516@gmail.com"}],"description":"CLI local para orquestração de agentes, documentação viva, backlog técnico e desenvolvimento assistido.","homepage":"https://github.com/aurumsoltec/AurumCortex#readme","keywords":["ai","agents","cli","developer-tools","opencode","workflow","backlog","architecture","automation","orchestration","aurumcortex"],"repository":{"type":"git","url":"git+https://github.com/aurumsoltec/AurumCortex.git"},"author":{"name":"AurumSolTec"},"bugs":{"url":"https://github.com/aurumsoltec/AurumCortex/issues"},"license":"UNLICENSED","readme":"# Aurum Cortex\r\n\r\nCLI local para orquestração de agentes, documentação viva, backlog técnico e execução assistida por ferramentas externas de desenvolvimento.\r\n\r\n## Objetivo\r\n\r\nAurum Cortex funciona como uma camada acima de ferramentas como Claude Code, OpenCode, Cursor, Codex e outros executores. Ele prepara contexto, documentação, histórias, critérios de aceite e prompts de execução; depois dispara o executor configurado ou gera um pacote para execução manual.\r\n\r\n## Instalação global Preview\r\n\r\n```bash\r\nnpm install -g @aurumsoltec/aurumcortex@latest\r\n```\r\n\r\nDepois:\r\n\r\n```bash\r\naurumcortex --version\r\naurumcortex about\r\nacx menu\r\n```\r\n\r\n### Validade da versão preview\r\n\r\nEsta versão preview é válida até **30/06/2026**.\r\nApós essa data, comandos operacionais serão bloqueados até atualização ou ativação futura\r\n(comandos como `--version`, `about`, `preview` e `update` continuam disponíveis).\r\n\r\nA versão atual ainda **não** possui licenciamento online. O sistema de licença/ativação será implementado em fase posterior.\r\n\r\n### O que o pacote npm publica\r\n\r\nO pacote npm publica `dist/`, `README.md`, as licenças (`LICENSE`, `LICENSE-PREVIEW.md`, `LICENSE-COMMERCIAL.md`), a camada de instalação (`install.js`, `install.ps1`, `install.sh`, `postinstall.js`), `docs/install/`, `targets-stubs/` e o `package.json`.\r\nO repositório privado, o código-fonte TypeScript em `src/`, os testes e os arquivos internos **não** são publicados.\r\nComo em toda CLI local, o JavaScript distribuído em `dist/` fica disponível no computador do usuário.\r\n\r\n## Distribuição npm Preview\r\n\r\nO pacote npm inclui uma camada de distribuição com:\r\n\r\n- `postinstall.js` — mensagem pós-instalação (apenas imprime próximos passos)\r\n- `install.js` — helper local de instalação/diagnóstico (verifica Node >= 20)\r\n- `install.ps1` — helper Windows (`-DryRun` / `-Yes`)\r\n- `install.sh` — helper Linux/macOS (`--dry-run` / `--yes`)\r\n- `docs/install/` — documentação de instalação (Windows, Linux/macOS, OpenCode, troubleshooting, checklist)\r\n- `targets-stubs/` — stubs/roadmap para agentes/ambientes (OpenCode, Claude Code, Cursor, Codex, VS Code)\r\n\r\nO bin principal continua direto:\r\n\r\n```bash\r\naurumcortex about\r\nacx menu\r\n```\r\n\r\nO helper de instalação é opcional:\r\n\r\n```bash\r\naurumcortex-install\r\n```\r\n\r\nA validação de publicação pode ser executada localmente com `npm run validate:publish`.\r\n\r\nReforçando:\r\n\r\n- o licenciamento real (online) ainda **não** está implementado;\r\n- a versão preview expira em **30/06/2026**;\r\n- `dist/` é distribuído; `src/`, `test/`, arquivos internos e segredos **não** são publicados.\r\n\r\n## Instalação local\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\nnpm link\r\n```\r\n\r\nDepois:\r\n\r\n```bash\r\naurum-cortex --help\r\nacx --help\r\n```\r\n\r\n## Workflow principal\r\n\r\n```bash\r\nacx arch-plan \"descrição detalhada\"\r\nacx commit\r\nacx create-epic \"COMO desenvolvedor, QUERO criar todos os épicos e histórias da arquitetura completa descrita em @docs/architecture/, PARA construir o projeto inteiro a partir do plano de arquitetura\"\r\nacx yolo @docs/epics/EPIC-01-core-foundation.md\r\nacx commit\r\nacx status\r\n```\r\n\r\n1. **`arch-plan` é a porta de entrada**: planeja (projeto novo) ou mapeia (projeto existente) a arquitetura em `docs/architecture/` + `docs/02-ARCHITECTURE.md`.\r\n2. **`create-epic` cria o backlog file-based**: um arquivo por épico (`docs/epics/`) e por história (`docs/stories/`), com índices `docs/06-EPICS.md`/`docs/07-STORIES.md`.\r\n3. **`yolo` aceita caminho `@docs/...`** (ex.: `acx yolo @docs/epics/EPIC-01-core-foundation.md`) além de `EPIC-01`/`STORY-001`.\r\n4. **`commit` é etapa oficial do workflow**: roda o `doctor`, bloqueia segredos (`.env`, `*.pem`, `*.key`, `node_modules/**`) e faz `git add`/`git commit` (push só com `--push`).\r\n5. **`doctor` valida a segurança antes da execução real.**\r\n\r\nPara projeto existente, comece com `acx arch-plan \"Mapear projeto existente: ...\"`.\r\n\r\nOs diferenciais técnicos do AurumCortex continuam disponíveis: `doctor`, `checkpoints`, `execution-report`, `review --story`, `story-status`, `story-done`, `backlog reindex --safe` e `yoloop` seguro.\r\n\r\n## Fluxo inicial (técnico/avançado)\r\n\r\n```bash\r\nacx init\r\nacx status\r\nacx scan\r\nacx architecture\r\nacx epics\r\nacx stories EPIC-01\r\nacx run STORY-001 --dry-run\r\nacx review --story STORY-001\r\nacx story-done STORY-001\r\nacx docs-sync\r\n```\r\n\r\n`acx status` funciona mesmo antes da inicialização e sempre indica o próximo passo recomendado.\r\n\r\n## Ciclo de vida das histórias\r\n\r\nO Aurum Cortex mantém o status de cada história em `.aurum-cortex/memory/stories.json`\r\n(`planned → active → review → done`) e o avanço entre elas:\r\n\r\n```bash\r\nacx run STORY-001 --dry-run        # marca a história como active\r\nacx review --story STORY-001       # marca a história como review e grava last-review.json\r\nacx story-status STORY-001 review  # define o status manualmente (planned|active|review|done)\r\nacx story-done STORY-001           # marca a história como done e aponta a próxima planned\r\n```\r\n\r\n`acx story-status STORY-001 review` (aliases: `acx set-story-status`, `acx status-story`)\r\ndefine o status diretamente, validando o valor e mostrando antes/depois.\r\n`acx story-done` (aliases: `acx done`, `acx complete`) conclui a história e **continua sendo\r\numa confirmação humana** — nada é marcado como `done` automaticamente.\r\n`acx status` mostra a contagem por status, a próxima história recomendada e o último review.\r\n\r\n## Revisão com validação de escopo\r\n\r\n`acx review` analisa o diff atual e gera um relatório em `docs/10-REVIEW-REPORTS/`\r\ne um resumo reutilizável em `.aurum-cortex/runtime/last-review.json` (consumido pelo gate de segurança).\r\nCom `--story`, ele valida os arquivos alterados contra `allowedFiles`/`forbiddenFiles` da história:\r\n\r\n```bash\r\nacx review                       # revisão básica (sem validação de escopo)\r\nacx review --story STORY-001     # valida escopo, classifica risco e registra lastReview\r\n```\r\n\r\n## Execução assistida (orquestração, não execução cega)\r\n\r\n`acx yolo` e `acx yoloop` **preparam pacotes de execução** em `.aurum-cortex/runtime/` por padrão (dry-run). Nada é executado de verdade sem `--execute` explícito.\r\n\r\n```bash\r\nacx yolo STORY-001\r\nacx yoloop EPIC-01 --limit 1\r\n```\r\n\r\n`yoloop` resolve apenas as histórias do épico, prioriza `active`/`review` antes de `planned`,\r\nignora as que estão `done` e respeita `--limit` (padrão 1) para nunca rodar de forma ilimitada.\r\n\r\n### Ciclo iterativo controlado (`--execute`)\r\n\r\nCom `--execute`, o `yoloop` roda um ciclo iterativo com checkpoint por história:\r\n\r\n```bash\r\nacx yoloop EPIC-01 --limit 1 --execute --auto-review\r\n```\r\n\r\nPara cada história ele: cria checkpoint `before-run`, aplica o gate de segurança, executa\r\n(reutilizando o fluxo de `run`), cria checkpoint `after-run` e — com `--auto-review` — roda o\r\nreview automático e cria checkpoint `after-review`.\r\n\r\n- **Não marca `done` automaticamente.** A conclusão é manual via `acx story-done` (a menos que\r\n  você use `--auto-complete`, que só conclui após um review limpo).\r\n- Os checkpoints ficam em `.aurum-cortex/runtime/checkpoints/`.\r\n- Sem `--auto-review`, o review é apenas recomendado (registrado em checkpoint).\r\n\r\n### Kill-switch\r\n\r\nO kill-switch fica **ativado por padrão** e interrompe o loop imediatamente quando: o gate\r\nfalha, o último review tem score `alto`, há violação de `forbiddenFiles`, a execução falha ou\r\nnão há história candidata. Use `--no-kill-switch` para relaxar a parada por score `alto`, mas\r\n**`forbiddenFiles` sempre bloqueia**.\r\n\r\n## Gate de segurança para execução real\r\n\r\nAntes de qualquer execução real (`--execute`), `run` e `yoloop` aplicam um gate de segurança que bloqueia a execução se:\r\n\r\n- a história não existir;\r\n- a história não tiver `acceptanceCriteria`;\r\n- a história não tiver `allowedFiles`;\r\n- houver violação de `forbiddenFiles` no diff atual;\r\n- o último review (`last-review.json`) tiver score `alto`;\r\n- o último review tiver `forbiddenHits`.\r\n\r\nO modo `--dry-run` (padrão) nunca é bloqueado, e `forbiddenFiles` sempre bloqueia mesmo com `--no-kill-switch`.\r\n\r\n## Reindexar o backlog\r\n\r\n`acx backlog reindex` (ou `acx backlog-reindex`) reconstrói `epics.json`/`stories.json` a partir\r\nde `docs/epics/` e `docs/stories/`, detectando o épico de cada história por frontmatter `epicId`\r\nou linhas como `Epic: EPIC-01` / `Épico: EPIC-01`. Ele **preserva o status e os campos existentes**\r\ne cria um backup em `.aurum-cortex/memory/backups/` antes de sobrescrever.\r\n\r\n```bash\r\nacx backlog reindex\r\n```\r\n\r\n### Reindex seguro (preview)\r\n\r\n`--safe` **não altera** `epics.json`/`stories.json`. Ele cria um backup e grava uma prévia em\r\n`.aurum-cortex/runtime/reindex-preview.json`, mostrando quantas mudanças seriam aplicadas.\r\nDepois, `--apply-preview` aplica a prévia (com backup):\r\n\r\n```bash\r\nacx backlog reindex --safe           # gera a prévia, sem alterar o backlog\r\nacx backlog reindex --apply-preview  # aplica a última prévia\r\n```\r\n\r\n## Rastreabilidade de execução\r\n\r\nCada execução real grava um `ExecutorResult` estruturado em\r\n`.aurum-cortex/runs/STORY-001-<timestamp>/execution-result.json` (status, exitCode, stdout/stderr,\r\nduração), além de `executor-output.log` e `execution-package.json`. O `project-state.json` e a story\r\npassam a registrar `lastRunStatus` (`success | failed | dry-run`). Se o executor falhar, `run`\r\nretorna exit code 1 e o `yoloop` para o loop com um checkpoint `blocked`.\r\n\r\n### Checkpoints\r\n\r\nListe a trilha de execução de uma história (criada durante `yoloop --execute`):\r\n\r\n```bash\r\nacx checkpoints STORY-001            # lista legível (before-run, after-run, after-review, ...)\r\nacx checkpoints STORY-001 --latest   # apenas o último checkpoint\r\nacx checkpoints STORY-001 --json     # saída em JSON\r\n```\r\n\r\n### Execution report\r\n\r\nGera um relatório consolidado (story, status, último run, último review, checkpoints, riscos e\r\npróximo passo) em `docs/10-REVIEW-REPORTS/EXECUTION-REPORT-STORY-001-<timestamp>.md`:\r\n\r\n```bash\r\nacx execution-report STORY-001       # aliases: acx report / acx story-report\r\n```\r\n\r\n## Diagnóstico com doctor\r\n\r\n`acx doctor` diagnostica a saúde do projeto **sem alterar nada**: estrutura, git (repo, branch,\r\nalterações pendentes, arquivos proibidos modificados), backlog (stories sem allowedFiles/\r\nacceptanceCriteria/epic, IDs duplicados/inválidos) e runtime (checkpoints, runs, último review).\r\nUse-o **antes de `yoloop --execute`**.\r\n\r\n```bash\r\nacx doctor\r\n```\r\n\r\nEle retorna exit code para CI: `0` (OK), `1` (ATENÇÃO), `2` (CRÍTICO). Em uso local interativo o\r\nexit code é informativo; em pipelines ele permite falhar a etapa quando o estado é crítico.\r\n\r\n## Fluxo recomendado\r\n\r\n```bash\r\nacx doctor\r\nacx status\r\nacx yoloop EPIC-01 --limit 1 --execute --auto-review --executor dry-run\r\nacx checkpoints STORY-001\r\nacx execution-report STORY-001\r\nacx story-done STORY-001\r\n```\r\n\r\n## Execução segura\r\n\r\nPor padrão, `run` trabalha em modo seguro. Para executar um adaptador externo, use `--execute` explicitamente. O comando final é configurável em `.aurum-cortex/config.json`.\r\n\r\n## Compatibilidade\r\n\r\nA primeira versão nasce com adaptadores configuráveis para:\r\n\r\n- `claude`\r\n- `opencode`\r\n- `shell`\r\n- `dry-run`\r\n\r\nComo CLIs externas mudam com frequência, os comandos são templates editáveis no arquivo de configuração local.\r\n\r\n## Runner local do projeto\r\n\r\nO Aurum Cortex cria um runner local dentro de cada projeto inicializado para evitar dependência de PATH global (problema comum no OpenCode).\r\n\r\n### O que é criado\r\n\r\nApós `aurumcortex init` ou `aurumcortex install-opencode`:\r\n\r\n- `.aurum-cortex/bin/aurumcortex.cmd` — Windows CMD runner\r\n- `.aurum-cortex/bin/aurumcortex.ps1` — Windows PowerShell runner\r\n- `.aurum-cortex/bin/aurumcortex` — POSIX runner (Linux/Mac)\r\n\r\n### Como funciona\r\n\r\nO runner local aponta para o Node.js e o entrypoint da CLI instalada globalmente. Dentro do OpenCode, em vez de chamar `acx` diretamente (que pode não estar no PATH do OpenCode), o roteador usa o runner local:\r\n\r\n```powershell\r\n.\\.aurum-cortex\\bin\\aurumcortex.cmd scan\r\n```\r\n\r\nNo Linux/Mac:\r\n\r\n```bash\r\n./.aurum-cortex/bin/aurumcortex scan\r\n```\r\n\r\n### Por que isso é necessário\r\n\r\nO OpenCode não herda necessariamente o PATH global do Windows. Se `acx` não for encontrado, o comando falha. O runner local resolve isso porque está dentro do diretório do projeto e é chamado com caminho relativo.\r\n\r\n## OpenCode usage\r\n\r\nO Aurum Cortex fornece uma integração autossuficiente com OpenCode via o arquivo `aurumcortex.md`. Após a instalação, o agente reconhece automaticamente comandos no formato `@acx *comando`.\r\n\r\n### Menções de agente\r\n\r\nO AurumCortex aceita três menções (todas equivalentes), com **`@acx` como recomendada**:\r\n\r\n- `@acx` (recomendada)\r\n- `@aurumcortex` (compatível)\r\n- `@aurum-cortex` (compatível)\r\n\r\n**Terminal usage:**\r\n\r\n```bash\r\nacx status\r\nacx arch-plan \"...\"\r\nacx commit\r\n```\r\n\r\n**Agent usage (OpenCode):**\r\n\r\n```text\r\n@acx *status\r\n@acx *arch-plan \"...\"\r\n@acx *commit\r\n```\r\n\r\nDentro do agente/OpenCode, nunca execute `acx` global diretamente — o roteador usa o runner local do projeto (`.\\.aurum-cortex\\bin\\aurumcortex.cmd` no Windows, `./.aurum-cortex/bin/aurumcortex` no POSIX).\r\n\r\n\r\n### Instalação\r\n\r\nA bridge é instalada automaticamente durante `acx init`:\r\n\r\n```bash\r\nacx init --type web\r\n```\r\n\r\nOu manualmente em um projeto existente:\r\n\r\n```bash\r\nacx install-opencode\r\n```\r\n\r\n### O que é criado\r\n\r\n- `aurumcortex.md` — arquivo principal reconhecido pelo OpenCode\r\n- `.aurum-cortex/opencode/aurumcortex.md` — cópia de controle\r\n- `.opencode/aurumcortex.md` — ponte adicional\r\n\r\nO arquivo `aurumcortex.md` é autossuficiente: contém o menu completo, regras de roteamento e instruções para responder qualquer comando `@aurumcortex`.\r\n\r\n### Uso dentro do OpenCode\r\n\r\nAbra o projeto no OpenCode. O arquivo `aurumcortex.md` na raiz é carregado automaticamente. Digite:\r\n\r\n```\r\n@acx *menu\r\n@acx *status\r\n@acx *arch-plan \"descrição detalhada\"\r\n@acx *commit\r\n@acx *create-epic \"pedido\"\r\n@acx *yolo @docs/epics/\r\n@acx *yoloop @docs/epics/\r\n@acx *scan\r\n@acx *architecture\r\n@acx *stories EPIC-01\r\n@acx *review\r\n@acx *docs-sync\r\n```\r\n\r\n> Os aliases `@aurumcortex` e `@aurum-cortex` continuam funcionando (ex.: `@aurumcortex *status`).\r\n\r\n### Compatibilidade\r\n\r\nComandos sem `*` também funcionam:\r\n- `@aurumcortex scan` é interpretado como `@aurumcortex *scan`\r\n\r\n### Menu no terminal\r\n\r\nPara ver o menu no terminal (comparando modos OpenCode e Terminal):\r\n\r\n```bash\r\naurumcortex menu\r\nacx menu          # alias curto\r\n```\r\n\r\n### Execução ponta a ponta com *yolo\r\n\r\n`*yolo` executa um epic ou story de ponta a ponta, do código aos testes.\r\n\r\n**Entradas aceitas:**\r\n- arquivo de epic (preferencial)\r\n- arquivo de story\r\n- ID de epic\r\n- ID de story\r\n- lista de stories\r\n\r\nExemplos:\r\n\r\n```\r\n@aurumcortex *yolo @docs/epics/EPIC-01-estrutura-base.md\r\n@aurumcortex *yolo @docs/stories/STORY-001-criar-html-base.md\r\n@aurumcortex *yolo EPIC-01\r\n@aurumcortex *yolo STORY-001 STORY-002\r\n```\r\n\r\n### Execução autônoma com *yoloop\r\n\r\n`*yoloop` executa automaticamente todas as stories de um epic em sequência com mecanismos de segurança integrados.\r\n\r\n**Mecanismos de segurança:**\r\n- **Caps:** limite máximo de stories (padrão: 1)\r\n- **Cool-down:** pausa entre stories\r\n- **Kill-switch:** interrompe em caso de erro, falha de teste, alteração fora de escopo\r\n- **Checkpoints:** revisão entre cada story\r\n\r\nExemplos:\r\n\r\n```\r\n@aurumcortex *yoloop @docs/epics/EPIC-01-estrutura-base.md\r\n@aurumcortex *yoloop @docs/epics/\r\n@aurumcortex *yoloop EPIC-01 --limit 2\r\n@aurumcortex *yoloop --from STORY-003 --limit 1\r\n```\r\n\r\n### Roteamento inteligente\r\n\r\nO usuário pode escrever apenas `@aurumcortex \"instrução\"` e o roteador infere o comando:\r\n\r\n```\r\n@aurumcortex \"crie os épicos e histórias a partir de @docs/\"\r\n@aurumcortex \"execute a STORY-001\"\r\n@aurumcortex \"continue a implementação das próximas histórias\"\r\n```\r\n\r\n### Fluxo recomendado no OpenCode\r\n\r\n1. `aurumcortex init --type web`\r\n2. Abrir o OpenCode na pasta do projeto\r\n3. `@aurumcortex *menu`\r\n4. `@aurumcortex *scan`\r\n5. `@aurumcortex *architecture`\r\n6. `@aurumcortex *epics`\r\n7. `@aurumcortex *stories EPIC-01`\r\n8. `@aurumcortex *prompt STORY-001`\r\n9. `@aurumcortex *run STORY-001`\r\n10. `@aurumcortex *review`\r\n11. `@aurumcortex *docs-sync`\r\n\r\n## Organização de épicos e histórias\r\n\r\nO Aurum Cortex adota o padrão de arquivos individuais para épicos e histórias, com pastas separadas.\r\n\r\n### Estrutura de diretórios\r\n\r\n```\r\ndocs/\r\n├── epics/\r\n│   ├── EPIC-01-nome-do-epico.md\r\n│   ├── EPIC-02-nome-do-epico.md\r\n│   └── EPIC-03-nome-do-epico.md\r\n├── stories/\r\n│   ├── STORY-001-nome-da-historia.md\r\n│   ├── STORY-002-nome-da-historia.md\r\n│   └── STORY-003-nome-da-historia.md\r\n├── 06-EPICS.md       (apenas índice)\r\n└── 07-STORIES.md     (apenas índice)\r\n```\r\n\r\n### Regras\r\n\r\n- `docs/epics/` contém um arquivo por épico com conteúdo completo.\r\n- `docs/stories/` contém um arquivo por história com conteúdo completo.\r\n- `docs/06-EPICS.md` é apenas o índice dos épicos (tabela resumida).\r\n- `docs/07-STORIES.md` é apenas o índice das histórias (tabela resumida).\r\n- `.aurum-cortex/memory/epics.json` armazena metadados.\r\n- `.aurum-cortex/memory/stories.json` armazena metadados.\r\n\r\n### Reorganizar backlog existente\r\n\r\nPara migrar um backlog antigo (arquivos únicos) para o novo padrão:\r\n\r\n```bash\r\naurumcortex organize-backlog\r\n```\r\n\r\nOu no OpenCode:\r\n\r\n```\r\n@aurumcortex *organize-backlog\r\n```\r\n\r\n### Criar backlog já no novo padrão\r\n\r\nAo usar `@aurumcortex *create-epic \"pedido\" @docs/`, o backlog já será gerado no novo padrão com arquivos individuais.\r\n\r\n## Criar épicos e histórias a partir de @docs/\r\n\r\nUse comandos de backlog completo dentro do OpenCode:\r\n\r\n```\r\n@aurumcortex *epics \"COMO desenvolvedor, QUERO criar todos os épicos e histórias da arquitetura completa descrita em @docs/, PARA construir o projeto inteiro a partir do plano de arquitetura\" @docs/\r\n```\r\n\r\nOu equivalente:\r\n\r\n```\r\n@aurumcortex *create-epic \"COMO desenvolvedor, QUERO criar todos os épicos e histórias da arquitetura completa descrita em @docs/, PARA construir o projeto inteiro a partir do plano de arquitetura\" @docs/\r\n```\r\n\r\nNo terminal:\r\n\r\n```bash\r\naurumcortex create-epic \"pedido\" --context docs\r\n```\r\n\r\n## Atualização\r\n\r\nPara atualizar a instalação global do Aurum Cortex:\r\n\r\n```bash\r\naurumcortex update\r\n```\r\n\r\nPara ver o comando que seria executado sem executar:\r\n\r\n```bash\r\naurumcortex update --dry-run\r\n```\r\n\r\nO comando executa `npm install -g git+https://github.com/aurumsoltec/AurumCortex.git`.\r\n","readmeFilename":"README.md","_rev":"1-12727123e9562d3e5b5598a147b822b1"}