{"_id":"@coefenix/ivvo-agent","_rev":"17-a30df8090bf63bc6589f32dcc2b3d01b","name":"@coefenix/ivvo-agent","dist-tags":{"latest":"2.6.4"},"versions":{"2.1.0":{"name":"@coefenix/ivvo-agent","version":"2.1.0","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.0","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"1cfe4d13aba375dfb52e1e163b69a18bf99e229e","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.0.tgz","fileCount":13,"integrity":"sha512-LKd5KZ2QDeiVwTx4Rt/O1Wcm4IAapfbikZbbvHlIoktoP3TsHXZ3bAVRZ5d4KmvuXb3gBEFSmwOkw4olQRD4kw==","signatures":[{"sig":"MEUCIEVjJCFxLIHpgPSeyCUK4Guz1M35QsLoOrW7Ddin0EsiAiEAijbryW0/9kjdv1wW/8np6u93U/Z3ToQHQYYW14WUWSE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95366},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"46181b75a3db86c681b3a36030eaeb31260be6c6","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.0_1779908762620_0.09035220636338193","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@coefenix/ivvo-agent","version":"2.1.1","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.1","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"942f1e27497d2da1c74a4a94fcd31517512f7631","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.1.tgz","fileCount":13,"integrity":"sha512-SKmxjtay0JP9MxF4Vkr/hisPw2gLjiuobn9RUQ4YSSxZ1rlYGQPl7Pconzk9+U5Khno5Ou2KD27iBup6Rmilgg==","signatures":[{"sig":"MEUCIC8lnguTiUi/4d3xKYVSM4H40GTh80ponB6Qpoo+VRihAiEA1Moa3v6gfTBBDXCCYIZmbxBvyJz2sNv+M6OFwS5RNBA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100853},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"828742b0d199ac2c62a54564f619648c40c6e112","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.1_1779910004627_0.648391080825067","host":"s3://npm-registry-packages-npm-production"}},"2.1.2":{"name":"@coefenix/ivvo-agent","version":"2.1.2","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.2","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"8b0189e7cedca59c6ce8a7a9bc68af6a219b6a3a","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.2.tgz","fileCount":419,"integrity":"sha512-14ORUGh7hwWkPx16sHDHpy7CerOiGPILKJBLB/7jvJ0n92wvagWWFy5/pZvH19LOZX4Nh9JEUXEdc9n70buzwg==","signatures":[{"sig":"MEUCIQDQnf5qlfZK7n3PLOCwi2sb82IsWJoZeUA6+E6qwlYJeQIgeQ7UI3D7L8qfEMEhk11S6utiXSEdRZliRsQmDLFtpao=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3239170},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"4fd1eebef1e6cf5dc394c2aa26bed6b66308632c","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.2_1779911424411_0.14164868059574975","host":"s3://npm-registry-packages-npm-production"}},"2.1.3":{"name":"@coefenix/ivvo-agent","version":"2.1.3","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.3","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"629febdade5f93341db15c3a0f8877451b853062","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.3.tgz","fileCount":431,"integrity":"sha512-qu5npH1H3r8mSUvCQbYNQ4K5NTV90qbt86DQ/uE8cLP803rAC0s9yETbyhnNEveLDEmS+TqnIsBu0KZnC7arlg==","signatures":[{"sig":"MEQCIHeQQvBcCbvcueGRpn3KTA0CAcXVG5O+QAlQYeEZUMexAiB6wi5Zl8B0OM/X1DSW1GLZZtzcrbhObhfXJ109OiWmgQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3354849},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"9353c35a74e323001d32d5c8e8c2268e2bcee121","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.3_1779912443588_0.036619425288970886","host":"s3://npm-registry-packages-npm-production"}},"2.1.4":{"name":"@coefenix/ivvo-agent","version":"2.1.4","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.4","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"1f227ed91f670cecd8e57348a45a27df84985ec1","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.4.tgz","fileCount":480,"integrity":"sha512-3sgN2crIodc8bzCD1Rf5nG+IZDN6tMvGdYvdQxWlrMrrk497q9nXHI1UmWxMXC4PLXohwxhJlea6t4F9NNbsKg==","signatures":[{"sig":"MEUCIQDpA7LKaeyiTdiLsc2J0EQRdht/MtLLj9EoZdRocMFPBwIgVlyRP1KHzjon/vSOxhgj+c+a+nbT4msCNGMW3HUedIM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3796309},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"f63ed586c354be2502d0a8237b76916f2fd07d41","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.4_1779913097458_0.19885633532044578","host":"s3://npm-registry-packages-npm-production"}},"2.1.5":{"name":"@coefenix/ivvo-agent","version":"2.1.5","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.5","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"1174edbbe0c6d1bb1960f11cbc08a0a96a0f65ba","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.5.tgz","fileCount":480,"integrity":"sha512-8JU2OWjF4VkqTGyAzfvaiHZTuGHi2x4n/0+wv7hYr9lD563YBqXQ7RQtCMJfa9+i0/ez6WN3z5uFFaa0Bxtzhg==","signatures":[{"sig":"MEQCIDx6wb6qlZgFo7GAL4HjMztuP06jQtggFr4DYYfCXILPAiAW83f7yLfP+trBn3j9srmk37+XDIXlMTJKe+ZKpz4Ddw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3797416},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"a7d1c99a8f38858419fca4f41d8ce0b19079f9ef","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.5_1779913711886_0.11523195007083364","host":"s3://npm-registry-packages-npm-production"}},"2.1.6":{"name":"@coefenix/ivvo-agent","version":"2.1.6","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.6","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"9f1e2d503449892ae866ac974da20c71fb0fbb57","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.6.tgz","fileCount":482,"integrity":"sha512-Nats7TNcvdgboIuuRSivaNW34OO9lR1+csLhrirO9CYDAHDMnBcVXWyHpYXC7TmodoaQZ1sLZffjq1qPdwf+ww==","signatures":[{"sig":"MEUCIQCxfuzvIHzDElgjr6XQG2vL6iXmmcgfOkCVVbBwy1l7SQIgEL0yLZNEb66nKDANGpr3cdQBHdqHJPxopxjMCu6d7RU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3810222},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"a14b5319c0ad3c61d5c6a8b73cb0b564b41b95c3","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.6_1779917857540_0.5102746294649041","host":"s3://npm-registry-packages-npm-production"}},"2.1.7":{"name":"@coefenix/ivvo-agent","version":"2.1.7","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.7","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"6a5ba41e976d09f5688b2f09c7bfdc89f32b1980","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.7.tgz","fileCount":498,"integrity":"sha512-zyackEuxqcU46T2WnlBz2APxpjyY+0X/QxnIux7BwM+aGrrijfjkC04dYFjaMmEq38peYl3M4Ve/v2N1Y92qnQ==","signatures":[{"sig":"MEYCIQCTH5hnm0LLHbnSn2+VgC9CzzEP7KyligVTJF7icynG6gIhANS/lbm8vYM74Rb9/QU7CVwp/sHnRpqmqeecbavo6kqO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3918479},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"1ebe6c020ef0b07049e603e4c449366811105673","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.7_1779923277767_0.3456880821061179","host":"s3://npm-registry-packages-npm-production"}},"2.1.9":{"name":"@coefenix/ivvo-agent","version":"2.1.9","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.9","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"c566a67c5e9a8c475571b2eb39eea12cca6a15af","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.9.tgz","fileCount":501,"integrity":"sha512-DQWSCo3oUHJJKFL5kGg7BT9iCyHjm/xaGJJyU6DvF42GXhDRuZBS1/bSZNxY0/s54ym+AfMetgg0O2QsicHK1w==","signatures":[{"sig":"MEUCIQCMPbjpz+GF7RYw/w4x9zjz0Yp5ED5sgH1K7fEtU4l2XgIgHDRMbaUUG6OuoVjf1YmzmFT3Oc8VnhJdDpyPBWjoPTs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4001701},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"8ed612b4303018412e3c77bfcd939bd1e5df2542","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.9_1780063349247_0.7198163950234202","host":"s3://npm-registry-packages-npm-production"}},"2.1.10":{"name":"@coefenix/ivvo-agent","version":"2.1.10","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.1.10","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"3b394eca508d1c8859d899498061479ce5be5c32","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.1.10.tgz","fileCount":506,"integrity":"sha512-6c3pPBltT9zx2G7v+IhWGpPmADb+vB8QT7MO/bOe22bEH6U2ewIRzZ/4UAj80GfCaFwqq0pDONmFr4petJEdbQ==","signatures":[{"sig":"MEUCIQCAf+qyW9Q5v5/Y5pCjJ18V28TQPHvVHmXTDxNOpuKC5QIgS847KD0NyisN+06eR3LyoOWrBkujCiaO64KSRxkSMsI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4024877},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"062fbd16829c3ea4f8854cd62c12d5c575a2b1d5","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.1.10_1780193392304_0.03387564810476951","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"name":"@coefenix/ivvo-agent","version":"2.2.0","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.2.0","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"ae0f424f2e7a10473070e99e873fc43768e1ff7b","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.2.0.tgz","fileCount":472,"integrity":"sha512-D9sQyeCSlAa7A1sDmrv0J6TzEx6Yp659i+xlF/Nyv7inRu7pvLyU5nSsu82TMBc9s6GUvQ2X99Xbt6w8znZDrA==","signatures":[{"sig":"MEYCIQC9vu1bXV3MpdhEgC+h25g+UVYumyi0b8OfFtEda621xgIhAN1HXIPSQuJXDsJN/0Cs5Pd3eSKYDN4hKuMg3/JVEaPH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3799613},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"8e30c3562842225e7fab195723a5c18de53a753c","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.2.0_1780693788576_0.7235759587919093","host":"s3://npm-registry-packages-npm-production"}},"2.3.0":{"name":"@coefenix/ivvo-agent","version":"2.3.0","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.3.0","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"0aa473e194e2c3d5d8d14b127a43010a76c4a467","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.3.0.tgz","fileCount":475,"integrity":"sha512-jrATF5c9SS+cnYZE3vC9Txvg4PHF7ajgVydTrH0sHBU/O7Lqm7yx9FPZERWzHQlueGEos0Dgd4Vt2ZcZekA0Og==","signatures":[{"sig":"MEUCIAWzFRzJvyUsdEVu+Tq34J8ciJ0noaeYFk7QOFo9+C5qAiEA4CppL798aAqMVIZUh6c7SzoaPmRdfCyG76VAIQj4Efc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3813451},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"bcf6c6e0723465b6d40350e28d33155ecd0238b6","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.3.0_1780695075413_0.27305726717908096","host":"s3://npm-registry-packages-npm-production"}},"2.4.0":{"name":"@coefenix/ivvo-agent","version":"2.4.0","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.4.0","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"65bf4767ec213a7734e5225719f989e78b0ceb0a","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.4.0.tgz","fileCount":474,"integrity":"sha512-kxkc08gsvquUHJRNp+jfizvjk4y7TZA3oZBA35fLz7H4DgIZ+ytjL/xeW6sVIvHwhyPT1Fqd2mJpvDTk3gjqFg==","signatures":[{"sig":"MEYCIQDgQf5h7f2y2KKQtQydJZrfzUjmHPSF3iQnwzRQdUc8qQIhAKTMXpaP6vA7FmCutQYzm9dwK8GZ8T/yQfrG5PJl+AXd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3812317},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"b8419a19ee89bb7b12e19e7d7276dc74f7bb8d33","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.4.0_1780695833644_0.5568649312905178","host":"s3://npm-registry-packages-npm-production"}},"2.5.0":{"name":"@coefenix/ivvo-agent","version":"2.5.0","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.5.0","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"9c6666b07e2c82e7c50384bbc3a6ff026dbbccaf","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.5.0.tgz","fileCount":474,"integrity":"sha512-JQInirVfFgjhup4tSsTzdcl5j/VbAsG8yljuMr6/Y2XtA8x0LkAiZeMY1q3k3DCKNItgGqrIdvOshjQskhzp2A==","signatures":[{"sig":"MEUCIERGgmgtiF2mTkeunc7CTmHDllMHMhVSuh5EtNQJRCx7AiEA9gQeTTlEfDNoavjRcjUHxoOaBtlhld9BSs9fUgWfDHw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":3832019},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"5374d6836aec2ccc1c38469801daae14f76c94a6","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.5.0_1780857669263_0.2621313749346985","host":"s3://npm-registry-packages-npm-production"}},"2.6.0":{"name":"@coefenix/ivvo-agent","version":"2.6.0","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.6.0","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"e5e175526600abc7cbbbce8639baff9c7fbc1da3","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.6.0.tgz","fileCount":321,"integrity":"sha512-VVjjNYxv6Mp2kUrSe2s6hUeoGCLvaqVRuYM3wCI/+6t5pg3SLnA8N9fLzkkzyOeWTRiFBDTGl51U/sOuiHP1RQ==","signatures":[{"sig":"MEUCIBsV2EoLgUhqxpcPCYa16IWjMmzJg39Zy1Sj0cD7iXqJAiEAnZhHy6eRq4CSlXIDjwtguUMHQwASP7JOw0PWGZDn1x8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2649897},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"223c06651cbc689bdbf0801b875cc042203a1adc","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.6.0_1781121657911_0.29808623910843846","host":"s3://npm-registry-packages-npm-production"}},"2.6.3":{"name":"@coefenix/ivvo-agent","version":"2.6.3","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"author":{"name":"COEFENIX"},"license":"MIT","_id":"@coefenix/ivvo-agent@2.6.3","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"homepage":"https://github.com/COEFENIX/ivvo-fenix","bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"dist":{"shasum":"7041b521c9c8584472dd394499ffc3b6e31580d1","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.6.3.tgz","fileCount":324,"integrity":"sha512-vZyfgm8pSc5/OcRDKvDVS5LeKLq2go2pr4zk4kLXlR0bgylZ9tmJQOkgLKCsZdktkjX5GuE3BjiuRPqLy7C6ig==","signatures":[{"sig":"MEYCIQCzkgrZNKvEU2L9kH6sWRLUd7U9VNz7QnLJeKBrzV3NPQIhAKvl6Azk5GL/R4TEQyu+mbuoyMBtAWQQppRhGFhygbYS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2650107},"main":"tools/installer/ivvo-cli.js","type":"module","engines":{"node":">=20.12.0"},"gitHead":"be019712eabce2d35370f9c9fd564955a2b681b0","scripts":{"install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options","install:local":"node tools/installer/ivvo-cli.js install"},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"repository":{"url":"git+https://github.com/COEFENIX/ivvo-fenix.git","type":"git"},"_npmVersion":"11.11.0","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","directories":{},"_nodeVersion":"24.14.1","dependencies":{"js-yaml":"^4.1.0","commander":"^12.1.0","@clack/prompts":"^0.9.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ivvo-agent_2.6.3_1781124634221_0.9039263881956545","host":"s3://npm-registry-packages-npm-production"}},"2.6.4":{"name":"@coefenix/ivvo-agent","version":"2.6.4","description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","author":{"name":"COEFENIX"},"license":"MIT","homepage":"https://github.com/COEFENIX/ivvo-fenix","repository":{"type":"git","url":"git+https://github.com/COEFENIX/ivvo-fenix.git"},"bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"engines":{"node":">=20.12.0"},"type":"module","main":"tools/installer/ivvo-cli.js","bin":{"ivvo":"tools/installer/ivvo-cli.js","ivvo-agent":"tools/installer/ivvo-cli.js"},"scripts":{"install:local":"node tools/installer/ivvo-cli.js install","install:next":"node tools/installer/ivvo-cli.js install --channel next","list-options":"node tools/installer/ivvo-cli.js list-options"},"dependencies":{"@clack/prompts":"^0.9.1","commander":"^12.1.0","js-yaml":"^4.1.0"},"publishConfig":{"access":"public"},"gitHead":"c9fd6e96613fc3aeacb50a9963f9e21def0ab21a","_id":"@coefenix/ivvo-agent@2.6.4","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-3KOukKoV2X/5R+OffdmR0KoJMjzkhorKW0p0zKvv7GE4pVEhVYDxgoSGwxfg6ztn92vG2j8eLReOVCld/ftGGg==","shasum":"b72ca3bb13be7fe1e511f20d6db3cb10e1fbddc5","tarball":"https://registry.npmjs.org/@coefenix/ivvo-agent/-/ivvo-agent-2.6.4.tgz","fileCount":324,"unpackedSize":2650099,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAHNz91ka2E2XTX8SlFT1EFVZK58BXRSffpvANRZlVt6AiEAzVGgo+ECPdYiwXRCRIyzJxzXuib1vVGmjXZmWq36cKs="}]},"_npmUser":{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"},"directories":{},"maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ivvo-agent_2.6.4_1781125232397_0.781087411230809"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-27T19:06:02.400Z","modified":"2026-06-10T21:00:32.721Z","2.1.0":"2026-05-27T19:06:02.841Z","2.1.1":"2026-05-27T19:26:44.791Z","2.1.2":"2026-05-27T19:50:24.564Z","2.1.3":"2026-05-27T20:07:23.823Z","2.1.4":"2026-05-27T20:18:17.653Z","2.1.5":"2026-05-27T20:28:32.091Z","2.1.6":"2026-05-27T21:37:37.752Z","2.1.7":"2026-05-27T23:07:58.020Z","2.1.9":"2026-05-29T14:02:29.457Z","2.1.10":"2026-05-31T02:09:52.482Z","2.2.0":"2026-06-05T21:09:48.821Z","2.3.0":"2026-06-05T21:31:15.608Z","2.4.0":"2026-06-05T21:43:53.840Z","2.5.0":"2026-06-07T18:41:09.438Z","2.6.0":"2026-06-10T20:00:58.101Z","2.6.3":"2026-06-10T20:50:34.445Z","2.6.4":"2026-06-10T21:00:32.609Z"},"bugs":{"url":"https://github.com/COEFENIX/ivvo-fenix/issues"},"author":{"name":"COEFENIX"},"license":"MIT","homepage":"https://github.com/COEFENIX/ivvo-fenix","keywords":["ai","agents","agile","safe","copilot","claude","cursor","ivvo","fenix","scrum","backlog","story"],"repository":{"type":"git","url":"git+https://github.com/COEFENIX/ivvo-fenix.git"},"description":"IVVO AgileAgent — Instalador CLI de agentes de IA para times de desenvolvimento","maintainers":[{"name":"giovannyesposito","email":"giovannyesposito@gmail.com"}],"readme":"
\r\n\r\n# IVVO AgileAgent\r\n\r\n**Kit de Agentes de Inteligência Artificial para Desenvolvimento Ágil de Software**\r\n\r\n_Do backlog ao deploy — movido por GitHub Copilot_\r\n\r\n---\r\n\r\n[![Agentes](https://img.shields.io/badge/Agentes-33-blue)](#agentes-especializados)\r\n[![Workflows](https://img.shields.io/badge/Workflows-40-green)](#slash-commands)\r\n[![Skills](https://img.shields.io/badge/Skills-93-orange)](#skills)\r\n[![MCPs](https://img.shields.io/badge/MCPs-3-purple)](#integração-mcp)\r\n[![Harness](https://img.shields.io/badge/Harness-100%2F100-brightgreen)](#agent-harness--governança-de-agentes)\r\n[![npm](https://img.shields.io/badge/npm-%40coefenix%2Fivvo--agent-red)](https://www.npmjs.com/package/@coefenix/ivvo-agent)\r\n[![Versão](https://img.shields.io/badge/Vers%C3%A3o-v2.1.0-informational)](#)\r\n[![PT-BR](https://img.shields.io/badge/Idioma-PT--BR-yellow)](#idioma)\r\n\r\n
\r\n\r\n---\r\n\r\n> **Instalação rápida:** `npx @coefenix/ivvo-agent install` \r\n> **Ambiente alvo:** VS Code + GitHub Copilot | Claude Code | Cursor | + 6 IDEs \r\n> **Idioma de uso:** Português Brasileiro (PT-BR) \r\n> **Versão:** v2.1.0 | **Última atualização:** Maio 2026 \r\n> **Score de Maturidade Arquitetural:** 10.0 / 10 (ver [RELEASE-NOTES-v2.0.md](RELEASE-NOTES-v2.0.md))\r\n\r\n---\r\n\r\n## Sumário\r\n\r\n1. [O que é o IVVO](#o-que-é-o-ivvo)\r\n2. [Instalação via npm (novo)](#instalação-via-npm-novo)\r\n3. [Pré-requisitos](#pré-requisitos)\r\n4. [Instalação e Onboarding](#instalação-e-onboarding)\r\n5. [Configuração do Ambiente](#configuração-do-ambiente)\r\n6. [Integração MCP](#integração-mcp)\r\n7. [Como Usar](#como-usar)\r\n8. [Slash Commands](#slash-commands)\r\n9. [Agentes Especializados](#agentes-especializados)\r\n10. [Skills](#skills)\r\n11. [Segurança e Observabilidade](#segurança-e-observabilidade)\r\n12. [Agent Harness — Governança de Agentes](#agent-harness--governança-de-agentes)\r\n13. [Grafo de Conhecimento em Duas Camadas](#grafo-de-conhecimento-em-duas-camadas)\r\n14. [Alinhamento Metodológico](#alinhamento-metodológico)\r\n15. [Estrutura do Projeto](#estrutura-do-projeto)\r\n16. [Organização de Artefatos](#organização-de-artefatos)\r\n17. [Memória e Contexto](#memória-e-contexto)\r\n18. [IVVO Context Engine — Arquitetura RAG](#ivvo-context-engine--arquitetura-rag)\r\n19. [Gate de Qualidade e DoD](#gate-de-qualidade-e-dod)\r\n20. [Idioma](#idioma)\r\n21. [Release Notes v2.1.0](#release-notes-v210)\r\n22. [Release Notes v2.0.0](#release-notes-v200)\r\n23. [Glossário](#glossário)\r\n\r\n---\r\n\r\n## O que é o IVVO?\r\n\r\nO **IVVO AgileAgent** é um sistema modular de agentes de IA especializados, projetado para auxiliar times de desenvolvimento e gestores de TI em todas as fases do ciclo de vida de software — da descoberta do produto ao encerramento pós-GOLIVE.\r\n\r\nO sistema opera como um **copiloto estratégico** integrado ao VS Code via GitHub Copilot. Ele planeja, estrutura, revisa e orienta. A execução é sempre do usuário.\r\n\r\n### O que o IVVO faz\r\n\r\n- Transforma ideias em **backlogs SAFe estruturados** com épicos, features e stories prontas para sprint\r\n- Cria **critérios de aceite em Gherkin** rastreáveis e auditáveis\r\n- Gera **planos de sprint**, revisão de código, planos de teste e ADRs automaticamente\r\n- Mapeia **riscos e dependências** (RAID) antes que virem incidentes\r\n- Produz **releases, runbooks e SLOs** com evidência de qualidade\r\n- Conduz **projetos de TI** com governança corporativa (SPTI, CHG, GMUD, Sprint Zero)\r\n- Analisa documentos externos (`.pptx`, `.docx`, `.pdf`, `.xlsx`) e converte em contexto estruturado\r\n- Mantém **memória persistente** com histórico de decisões e índice de conceitos por projeto\r\n- **Governa a execução dos próprios agentes** via Agent Harness — controle de permissões, detecção de loops, proteção contra rate limit de APIs externas e compressão inteligente de contexto\r\n\r\n### O que o IVVO não faz\r\n\r\n- Não altera código existente sem aprovação explícita\r\n- Não apaga nem sobrescreve arquivos do repositório\r\n- Não cria branches nem faz commits automaticamente\r\n- Não executa scripts sem que o usuário acione via terminal\r\n- Não expõe credenciais ou dados sensíveis em artefatos gerados\r\n\r\n---\r\n\r\n## Pré-requisitos\r\n\r\n| Requisito | Versão mínima | Finalidade |\r\n|---|---|---|\r\n| **VS Code** | 1.90+ | Editor principal |\r\n| **GitHub Copilot** | Assinatura ativa | Motor de IA dos agentes |\r\n| **Node.js** | 20.12+ | Instalador CLI `npx @coefenix/ivvo-agent` |\r\n| **Python** | 3.10+ | Scripts de automação e conversão |\r\n| **Git** | qualquer | Controle de versão local |\r\n\r\n### Verificar instalações\r\n\r\n```powershell\r\nnode --version\r\npython --version\r\ngit --version\r\n```\r\n\r\n### Extensões VS Code recomendadas\r\n\r\n- **GitHub Copilot** — obrigatório (`GitHub.copilot`)\r\n- **GitHub Copilot Chat** — obrigatório (`GitHub.copilot-chat`)\r\n- **Markdown All in One** — render e edição de artefatos\r\n- **Python** — suporte aos scripts do IVVO\r\n\r\n---\r\n\r\n## Instalação via npm (novo)\r\n\r\n> **Requer:** Node.js 20.12+ e uma conta [npmjs.com](https://www.npmjs.com)\r\n\r\nO IVVO agora é distribuído como pacote npm — sem necessidade de clonar o repositório. O instalador CLI copia apenas os módulos escolhidos para o projeto ou globalmente.\r\n\r\n### Instalação interativa\r\n\r\n```bash\r\nnpx @coefenix/ivvo-agent install\r\n```\r\n\r\nO CLI guia você por um fluxo interativo com seleção de IDE, módulos e escopo.\r\n\r\n### Instalação direta (CI/CD)\r\n\r\n```bash\r\n# Instala núcleo + agentes IVVO + workflows para GitHub Copilot, sem prompts\r\nnpx @coefenix/ivvo-agent install --yes --tools copilot --modules core,agents-ivvo,workflows\r\n```\r\n\r\n### Atualização preservando customizações locais\r\n\r\n```bash\r\nnpx @coefenix/ivvo-agent install --update\r\n```\r\n\r\nA sincronização usa **SHA-256** — arquivos modificados localmente são preservados; apenas o que mudou upstream é atualizado.\r\n\r\n### Opções disponíveis\r\n\r\n| Flag | Descrição | Exemplo |\r\n|---|---|---|\r\n| `--tools ` | IDE alvo | `copilot`, `claude-code`, `cursor`, `codex` |\r\n| `--modules ` | Módulos separados por vírgula | `core,agents-ivvo,workflows,skills` |\r\n| `--scope ` | Instala no projeto ou globalmente | `--scope global` |\r\n| `--channel ` | `stable` (padrão) ou `next` (pré-release) | `--channel next` |\r\n| `--set ` | Sobrescreve configuração de módulo | `--set core.language=pt-BR` |\r\n| `--yes` | Modo não-interativo para CI/CD | `--yes` |\r\n| `--update` | Atualiza preservando arquivos locais modificados | `--update` |\r\n| `--directory ` | Diretório de destino | `--directory /meu/projeto` |\r\n\r\n### Módulos disponíveis\r\n\r\n| Módulo | Conteúdo | Padrão |\r\n|---|---|:---:|\r\n| `core` | Regras globais, MIND.md, templates, configurações | ✅ |\r\n| `agents-ivvo` | 13 agentes de produto e agilidade | ✅ |\r\n| `agents-kit` | 20 agentes técnicos (frontend, backend, devops...) | — |\r\n| `workflows` | 40 slash commands prontos para uso | ✅ |\r\n| `skills` | 50+ módulos de conhecimento por domínio | ✅ |\r\n| `scripts` | 40+ scripts Python/PowerShell de automação | — |\r\n| `context-engine` | Motor RAG semântico BM25 + SQLite + FastAPI | — |\r\n| `governance-ti` | Workflows SPTI, CHG, GMUD, Sprint Zero, pós-GOLIVE | — |\r\n\r\n### IDEs suportadas\r\n\r\n| IDE | Código | Caminhos configurados automaticamente |\r\n|---|---|---|\r\n| **GitHub Copilot** | `copilot` | `.github/agents/`, `.github/copilot/prompts/`, `.vscode/settings.json` |\r\n| **Claude Code** | `claude-code` | `.claude/agents/`, `.claude/commands/`, `.claude/skills/` |\r\n| **Cursor** | `cursor` | `.agents/skills/`, `.cursorrules` |\r\n| **OpenAI Codex** | `codex` | `.agents/skills/` |\r\n| **Windsurf** | `windsurf` | `.agents/skills/`, `.windsurfrules` |\r\n| **Cline** | `cline` | `.agents/skills/`, `.clinerules` |\r\n| **Continue.dev** | `continue` | `.continue/agents/` |\r\n| **Aider** | `aider` | `.agents/skills/`, `.aider.conf.yml` |\r\n| Genérico | `generic` | `.agents/skills/` |\r\n\r\n### Instalação alternativa — clone direto\r\n\r\n```powershell\r\ngit clone https://github.com/COEFENIX/ivvo-fenix.git\r\ncd ivvo-fenix\r\n.\\setup.ps1\r\n```\r\n\r\nO `setup.ps1` é mantido como fallback para ambientes sem Node.js.\r\n\r\n### Pós-clone — Context Engine (obrigatório)\r\n\r\nApós clonar (por qualquer método), inicialize a base de contexto:\r\n\r\n```bash\r\n# Instala git hooks E inicializa o Context Engine automaticamente\r\npowershell -ExecutionPolicy Bypass -File .agent/scripts/infra/install_hooks.ps1\r\n\r\n# Ou apenas o Context Engine, se os hooks já estiverem instalados\r\npython .agent/scripts/ai/ivvo_rag.py migrate\r\n```\r\n\r\nO comando `migrate` é **idempotente** — pode ser executado quantas vezes quiser, só age quando necessário. Popula a base SQLite com os dados universais do Programa Fenix (domínios, sistemas, SAFe, SDD, Modelo Operativo) sem necessidade de servidor.\r\n\r\n---\r\n\r\n## Configuração do Ambiente\r\n\r\n### Variáveis de Ambiente e Credenciais\r\n\r\nO diretório `.config/.venv/` armazena credenciais de integração **localmente** — nunca commitadas no repositório:\r\n\r\n```\r\n.config/\r\n└── .venv/\r\n ├── mcp-atlassian.env ← credenciais Jira + Confluence\r\n └── mcp-atlassian.env.example\r\n```\r\n\r\n### Criar o diretório manualmente\r\n\r\n```powershell\r\nNew-Item -ItemType Directory -Force .config/.venv\r\n```\r\n\r\nO arquivo `.config/.venv/mcp-atlassian.env` é criado automaticamente ao executar o script de configuração do MCP Atlassian (ver seção abaixo).\r\n\r\n---\r\n\r\n## Integração MCP\r\n\r\nO IVVO suporta três servidores MCP (Model Context Protocol) para integração com ferramentas externas:\r\n\r\n| MCP | Ferramentas | Status |\r\n|---|---|---|\r\n| **Atlassian** (Jira + Confluence) | Criar/atualizar issues, publicar páginas, pesquisar | ✅ Ativo |\r\n| **Figma** | Criar frames/designs, consultar arquivos, geração de slides | ✅ Ativo (conta corporativa) |\r\n| **ServiceNow** | Consultar incidentes, mudanças, problemas, CMDB | ⚠️ 401 — aguardando MFA/allowlist |\r\n\r\n---\r\n\r\n### MCP Atlassian (Jira + Confluence)\r\n\r\nO IVVO suporta integração com **Jira** e **Confluence** via servidor MCP, que permite ao Copilot criar, atualizar e consultar issues diretamente durante a conversa.\r\n\r\n#### Instalar o mcp-atlassian\r\n\r\n```powershell\r\npython -m pip install --user mcp-atlassian\r\n```\r\n\r\n#### Configurar credenciais\r\n\r\nExecute o script interativo — ele cria `.config/.venv/mcp-atlassian.env` de forma segura:\r\n\r\n```powershell\r\n.\\.agent/scripts/infra/configure_mcp_atlassian.ps1\r\n```\r\n\r\nO script solicitará:\r\n\r\n| Campo | Descrição |\r\n|---|---|\r\n| `JIRA_URL` | URL da instância Jira |\r\n| `JIRA_USERNAME` | E-mail Atlassian |\r\n| `JIRA_API_TOKEN` | Token gerado em id.atlassian.com |\r\n| `CONFLUENCE_URL` | URL da instância Confluence |\r\n| `CONFLUENCE_USERNAME` | E-mail Atlassian |\r\n| `CONFLUENCE_API_TOKEN` | Token de API (pode reusar o do Jira) |\r\n\r\n> Gere o token em: [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\r\n\r\n#### Iniciar o servidor MCP\r\n\r\n```powershell\r\n.\\.agent/scripts/infra/start_mcp_atlassian.ps1\r\n```\r\n\r\n---\r\n\r\n### Configuração no VS Code (`.vscode/mcp.json`)\r\n\r\n```json\r\n{\r\n \"inputs\": [],\r\n \"servers\": {\r\n \"mcp-atlassian\": { \"type\": \"stdio\", \"command\": \"powershell\", \"args\": [\"...start_mcp_atlassian.ps1\"] },\r\n \"miro-mcp\": { \"url\": \"https://mcp.miro.com/\", \"type\": \"http\" },\r\n \"azure\": { \"type\": \"stdio\", \"command\": \"npx\", \"args\": [\"-y\", \"@azure/mcp@latest\", \"server\", \"start\", \"--readonly\", \"true\"] }\r\n }\r\n}\r\n```\r\n\r\n---\r\n\r\n## Como Usar\r\n\r\n### Início Rápido\r\n\r\n```\r\n/create minha nova feature de [descreva aqui]\r\n```\r\n\r\nO IVVO executa automaticamente:\r\n\r\n1. Classifica o tipo de projeto (Greenfield ou Brownfield)\r\n2. Gera: Brief → PRD → Backlog SAFe → RAID\r\n3. Salva artefatos em `demandas_processadas//`\r\n\r\n### Fluxo Completo de Desenvolvimento\r\n\r\n```\r\n/create [ideia] → Brief + PRD + backlog\r\n/clarificar [escopo] → Resolve ambiguidades antes de codificar\r\n/story [descrição] → Stories + ACs Gherkin + DoR checklist\r\n/sprint --capacity 40 → Plano de sprint validado\r\n/implement --story US-001 → Código + testes TDD\r\n/review [PR/diff] → Code review com contexto de story\r\n/test --story US-001 → Test plan + feature files\r\n/quality --story US-001 → Gate DoD (PASS / WARNING / BLOCKER)\r\n/release --version v1.0.0 → Release Notes + Runbook + Smoke test\r\n```\r\n\r\n### Roteamento Automático\r\n\r\nO IVVO identifica o agente correto automaticamente. Escreva naturalmente:\r\n\r\n| O que você escreve | Agente ativado |\r\n|---|---|\r\n| \"preciso de uma nova feature\" | `@product-discovery` |\r\n| \"story do fluxo de login\" | `@story-crafter` |\r\n| \"planejamento do próximo sprint\" | `@backlog-architect` |\r\n| \"implementar o endpoint X\" | `@code-author` |\r\n| \"revisar esse PR\" | `@review-master` |\r\n| \"criar testes para a US-042\" | `@test-engineer` |\r\n| \"validar o DoD da story\" | `@quality-guardian` |\r\n| \"mapear riscos do sprint\" | `@risk-analyst` |\r\n| \"documentar decisão de arquitetura\" | `@tech-decision-maker` |\r\n| \"status do projeto\" | `@delivery-observer` |\r\n| \"análise da SPTI\" | `@gerente-de-projetos-ti` |\r\n\r\n### Orquestração Multi-agente\r\n\r\nPara tarefas que cruzam múltiplos domínios:\r\n\r\n```\r\n/orchestrate gere story, testes e risk register da feature de desconto\r\n```\r\n\r\nO `@ivvo-orchestrator` distribui o trabalho em paralelo e consolida os resultados.\r\n\r\n### Ingressar em um Projeto Existente\r\n\r\n1. Copie `.agent/` para a raiz do seu projeto (não altera nenhum arquivo existente)\r\n2. Crie `uploads//Recursos/PROJECT_CONTEXT.md` com descrição, stack e decisões já tomadas\r\n3. Use `/create --mode bf` para Brownfield ou `/create --mode gf` para Greenfield\r\n\r\n---\r\n\r\n## Slash Commands\r\n\r\n### Ciclo de Desenvolvimento\r\n\r\n| Comando | O que faz |\r\n|---|---|\r\n| `/create [ideia]` | Discovery completo: Brief → PRD → Backlog → RAID |\r\n| `/clarificar [escopo]` | Levanta ambiguidades, premissas e gaps antes de agir |\r\n| `/story [descrição]` | Story + ACs Gherkin + DoR checklist |\r\n| `/analisar [escopo]` | Consistência e rastreabilidade entre artefatos |\r\n| `/checklist [escopo]` | Checklist de prontidão, qualidade ou aceite |\r\n| `/sprint --capacity N` | Plano de sprint com capacidade balanceada |\r\n| `/implement --story US-XX` | Código + testes TDD rastreável a ACs |\r\n| `/review [PR/diff]` | Code review com contexto de story e ADRs |\r\n| `/test --story US-XX` | Test Plan + arquivos `.feature` + Coverage Matrix |\r\n| `/quality --story US-XX` | Gate DoD: ✅ PASS / ⚠️ WARNING / ❌ BLOCKER |\r\n| `/risk --sprint N` | RAID Log + Risk-Adjusted Backlog |\r\n| `/decision [escolha]` | ADR ou RFC versionado |\r\n| `/release --version vX.Y.Z` | Release Notes + Runbook + Smoke checklist |\r\n| `/status` | Dashboard: backlog + DORA + riscos |\r\n| `/observe --slo` | SLOs + Runbooks + DORA Metrics |\r\n| `/orchestrate [tarefa]` | Coordenação multi-agente paralela |\r\n| `/fenix-flow [iniciativa]` | Fluxo ponta a ponta: PRD Review → Arquitetura → Story Map → Backlog → ADRs → RAID |\r\n| `/publish-confluence --context [slug]` | Publica artefatos no Confluence |\r\n| `/export-pdf --dest [--context ]` | Exporta artefatos para PDF sob demanda no caminho informado |\r\n| `/memory-refresh --context [slug]` | Reconcilia memória e cofre do contexto |\r\n| `/novo-contexto-brain` | Ingesta conhecimento por domínio no cofre |\r\n| `/contexto-rag --file --context ` | Ingesta arquivo externo no sistema de contexto |\r\n| `/compress-session` | Comprime contexto mid-session preservando decisões e pendências |\r\n\r\n### Gestão de Projetos TI\r\n\r\n| Comando | O que faz |\r\n|---|---|\r\n| `/analise-spti [projeto]` | Analisa maturidade da SPTI |\r\n| `/estruturacao-jira [projeto]` | Estrutura Jira com épicos, histórias e subtarefas |\r\n| `/planejamento-atividades [projeto]` | Kick-Off, Sprint Zero, cronograma, alocação |\r\n| `/checklist-pre-chg [projeto]` | Checklist obrigatório pré-CHG/GMUD |\r\n| `/pos-golive [projeto]` | Encerramento operacional pós-GOLIVE |\r\n| `/gestao-riscos-projeto [projeto]` | Mapa de riscos, mitigação, responsáveis, prazos |\r\n| `/cronograma-metricas [projeto]` | Cronograma e burnup do projeto |\r\n| `/status-report-executivo [projeto]` | Status report semanal para stakeholders |\r\n\r\n### Segurança — Guardrail Gate\r\n\r\n| Comando | O que faz |\r\n|---|---|\r\n| `/guardrail-check [skill]` | Verifica se a skill está autorizada para execução |\r\n| `/guardrail-approve \"\"` | Autoriza execução de uma skill (TTL por nível de risco) |\r\n| `/guardrail-status [--detail]` | Dashboard de status de todas as skills monitoradas |\r\n| `/guardrail-revoke ` | Revoga autorização ativa imediatamente |\r\n| `/guardrail-log [--last N] [--skill X] [--sql]` | Histórico de autorizações e bloqueios |\r\n| `/sql-guard \"\"` | Valida query SQL (SELECT-only) antes de executar |\r\n\r\n### Flags Comuns\r\n\r\n| Flag | Compatível com | Descrição |\r\n|---|---|---|\r\n| `--mode gf / bf` | `/create` | Trilha Greenfield ou Brownfield |\r\n| `--capacity N` | `/sprint` | Capacidade em pontos |\r\n| `--story US-XX` | `/implement`, `/test`, `/quality` | Filtra por story |\r\n| `--version vX.Y.Z` | `/release` | Define versão |\r\n| `--context ` | `/memory-refresh`, `/contexto-rag` | Define o contexto |\r\n\r\n---\r\n\r\n## Agentes Especializados\r\n\r\nO IVVO possui **33 agentes** em dois grupos.\r\n\r\n### Agentes IVVO — Produto, Agilidade e Gestão TI\r\n\r\n| Agente | Papel |\r\n|---|---|\r\n| `@product-discovery` | Discovery de produto, Brief, PRD, personas |\r\n| `@story-crafter` | Stories SAFe, ACs Gherkin, DoR, DoD |\r\n| `@backlog-architect` | Backlog SAFe, WSJF/RICE/MoSCoW, sprint planning |\r\n| `@code-author` | Implementação TDD rastreável a ACs |\r\n| `@review-master` | Code review com contexto SAFe e ADRs |\r\n| `@test-engineer` | Test plan, BDD/Gherkin, feature files, coverage matrix |\r\n| `@quality-guardian` | Gate DoD, validação de ACs e qualidade |\r\n| `@risk-analyst` | RAID log, risk-adjusted backlog, mitigação |\r\n| `@tech-decision-maker` | ADRs, RFCs, decisões de arquitetura |\r\n| `@delivery-observer` | DORA metrics, SLOs, runbooks, release tracking |\r\n| `@ivvo-orchestrator` | Orquestração multi-agente paralela e sequencial |\r\n| `@prd-reviewer` | Validação de consistência e qualidade de PRD |\r\n| `@project-classifier` | Classificação Greenfield / Brownfield |\r\n| `@gerente-de-projetos-ti` | SPTI, Jira, CHG, GMUD, Sprint Zero, status report |\r\n\r\n### Agentes KIT — Técnicos e Especializados\r\n\r\n| Agente | Papel |\r\n|---|---|\r\n| `@frontend-specialist` | UI/UX web, React/Next.js, Tailwind |\r\n| `@backend-specialist` | APIs REST/GraphQL, NestJS, Node.js |\r\n| `@database-architect` | Schema design, SQL, Prisma, migrações |\r\n| `@mobile-developer` | iOS, Android, React Native |\r\n| `@devops-engineer` | CI/CD, Docker, GitHub Actions |\r\n| `@security-auditor` | OWASP Top 10, compliance, secrets scanning |\r\n| `@qa-automation-engineer` | E2E automatizado, pipelines de qualidade |\r\n| `@debugger` | Análise de causa raiz, debugging sistemático |\r\n| `@performance-optimizer` | Core Web Vitals, profiling, otimização |\r\n| `@documentation-writer` | README, manuais técnicos, docs de API |\r\n| `@ux-designer` | Design de interfaces, protótipos |\r\n| `@code-archaeologist` | Código legado, reverse engineering |\r\n| `@explorer-agent` | Auditoria de codebase, análise arquitetural |\r\n| `@project-planner` | Planejamento, decomposição de work |\r\n| `@orchestrator` | Coordenação multi-agente técnica (KIT) |\r\n\r\nVer lista completa em `.agent/agents/`.\r\n\r\n---\r\n\r\n## Skills\r\n\r\nMódulos de conhecimento carregados pelos agentes conforme a necessidade. Ficam em `.agent/skills/`.\r\n\r\n| Categoria | Exemplos de skills |\r\n|---|---|\r\n| **Produto & Agilidade** | `project-discovery`, `user-story-craft`, `backlog-management`, `risk-management`, `quality-gates`, `adr-patterns`, `bcp-counting` |\r\n| **Gestão de Projetos TI** | `analise-spti`, `estruturacao-jira`, `planejamento-atividades`, `checklist-pre-chg`, `pos-golive`, `status-report-executivo` |\r\n| **Frontend & Design** | `frontend-design`, `tailwind-patterns`, `nextjs-react-expert`, `web-design-guidelines` |\r\n| **Backend & Database** | `api-patterns`, `nodejs-best-practices`, `python-patterns`, `database-design` |\r\n| **Testes & Qualidade** | `testing-patterns`, `tdd-workflow`, `test-artifact-generation`, `vulnerability-scanner` |\r\n| **DevOps & Arquitetura** | `deployment-procedures`, `observability-patterns`, `architecture`, `clean-code` |\r\n| **Agentes & Orquestração** | `orchestration-patterns`, `parallel-agents`, `intelligent-routing`, `orchestrator-langgraph`, `orchestrator-agentops` |\r\n| **Agentes Downstream (CLOCK02)** | `code-author-autogen`, `agent-builder-autogen`, `rag-continual-learning`, `delivery-observer-sql`, `security-red-team`, `azure-iac-engineer`, `gcp-analytics-agent`, `harness-cicd-engineer`, `mulesoft-developer`, `kafka-event-architect`, `salesforce-developer`, `servicenow-developer`, `siebel-developer`, `brm-developer`, `hpesd-developer`, `elastic-observability`, `openapi-3scale-developer` + 10 mais |\r\n\r\nVer listagem completa em `.agent/skills/`. O catálogo completo (93 skills) está em `.agent/skills/SKILL-REGISTRY.json`, gerado via `skill_registry.py`.\r\n\r\n---\r\n\r\n## Segurança e Observabilidade\r\n\r\n### Guardrail Gate — Autorização HITL para Skills de Alto Risco\r\n\r\nCamada de autorização humana obrigatória para skills classificadas como `CRITICAL` ou `HIGH`. Nenhum agente pode invocar essas skills sem aprovação prévia do usuário, com TTL configurável por nível de risco.\r\n\r\n```powershell\r\n# Dashboard completo\r\npy .agent/scripts/guards/guardrail_gate.py status\r\n\r\n# Autorizar skill para a sessão\r\npy .agent/scripts/guards/guardrail_gate.py approve code-author-autogen \"TDD US-42 sprint 6\"\r\n\r\n# Revogar imediatamente\r\npy .agent/scripts/guards/guardrail_gate.py revoke security-red-team\r\n\r\n# Histórico de eventos\r\npy .agent/scripts/guards/guardrail_gate.py log --last 20\r\n```\r\n\r\n| Skill | Nível | TTL | Requisito Adicional |\r\n|---|---|---|---|\r\n| `code-author-autogen` | CRITICAL | 60min | — |\r\n| `agent-builder-autogen` | CRITICAL | 30min | — |\r\n| `rag-continual-learning` | CRITICAL | 120min | — |\r\n| `delivery-observer-sql` | CRITICAL | 30min | `sql_guard.py` |\r\n| `security-red-team` | HIGH | 120min | `IVVO_ENV=staging` obrigatório |\r\n| `azure-iac-engineer` | HIGH | 60min | — |\r\n| `gcp-analytics-agent` | HIGH | 60min | — |\r\n\r\n> Audit log: `.agent/.guardrails/audit.jsonl` | Slash commands: `/guardrail-*`\r\n\r\n### SQL Guard — SELECT-only para Consultas de Dados\r\n\r\nEnforcer de segurança para queries geradas pelo `delivery-observer-sql`. Bloqueia DDL/DML, limita retorno a 5.000 linhas e registra toda execução.\r\n\r\n```powershell\r\n# Validar query antes de executar\r\npy .agent/scripts/guards/sql_guard.py validate \"SELECT * FROM issues WHERE sprint = 3\"\r\n# Exit 0 = seguro | Exit 1 = bloqueado\r\n\r\npy .agent/scripts/guards/sql_guard.py log\r\n```\r\n\r\n---\r\n\r\n### Prompt Injection Defense (`ivvo_sanitizer.py`)\r\n\r\nBarreira obrigatória entre `uploads/` e o motor de contexto RAG. Detecta padrões de injeção (override de persona, exfiltração de dados, bypass de segurança) e dados sensíveis (tokens Atlassian, API keys, passwords) antes de qualquer ingestão.\r\n\r\n```powershell\r\n# Executado automaticamente antes de ivvo_contexto.py\r\npython .agent/scripts/guards/ivvo_sanitizer.py --file uploads/meu-doc.md\r\n# Exit 0 = seguro | Exit 1 = ameaça detectada → ingestão bloqueada\r\n```\r\n\r\n### Telemetria de Agentes\r\n\r\nEventos de uso coletados automaticamente em background no banco SQLite `ivvo_telemetry.db`:\r\n- **Automático por evento**: cada `search`, `ingest` e `history ingest` registra um evento\r\n- **Automático por commit**: hook `post-commit` infere agente e contexto da mensagem\r\n- **Automático por sessão**: task VS Code registra `session-start` ao abrir o workspace\r\n- **Coleta periódica**: Windows Task Scheduler (`register_metrics_task.ps1`) a cada 15 min\r\n\r\n```powershell\r\n# Ver estatísticas de uso (últimos 30 dias)\r\npython .agent/scripts/ai/ivvo_rag.py telemetry stats\r\n\r\n# Filtrar por agente ou período\r\npython .agent/scripts/ai/ivvo_rag.py telemetry stats --agent story-crafter --days 7\r\n```\r\n\r\n### Pre-commit Hook — Proteção contra Vazamento de Credenciais\r\n\r\nHook instalado em `.git/hooks/pre-commit` que bloqueia commits com tokens, Bearer tokens, API keys ou passwords em plain-text.\r\n\r\n```powershell\r\n# Executar uma única vez após clone — instala hooks E inicializa o Context Engine\r\npowershell -ExecutionPolicy Bypass -File .agent/scripts/infra/install_hooks.ps1\r\n```\r\n\r\n---\r\n\r\n## Agent Harness — Governança de Agentes\r\n\r\nO **Agent Harness** é a camada de controle e segurança que governa o comportamento dos agentes IVVO em tempo de execução. Ele garante que os agentes operem dentro dos limites corretos, sem desperdiçar recursos, sem violar permissões e sem travar o trabalho do time.\r\n\r\n> Pontuação de maturidade atual: **100/100** _(v2.0.0 — ver [RELEASE-NOTES-v2.0.md](RELEASE-NOTES-v2.0.md))_\r\n\r\n### Por que isso importa?\r\n\r\nAgentes de IA sem governança cometem erros silenciosos e custosos:\r\n\r\n| Problema sem Harness | O que acontece na prática |\r\n|---|---|\r\n| Agente sem controle de permissão | Um agente de produto executa um `Bash` e apaga arquivos acidentalmente |\r\n| Loop sem detecção | Agente chama `pytest` 20× seguidas sem alterar o código — trava a sessão e consome tokens |\r\n| Loop em chamadas de API externa | Agente repete requisições à mesma API (Jira, Confluence, ServiceNow) sem recuo — dispara **rate limit** e bloqueia o time inteiro por horas |\r\n| Contexto sem compressão | Sessão longa perde coerência, agentes começam a contradizer decisões anteriores |\r\n\r\nO Harness resolve todos esses cenários programaticamente, sem depender de boa vontade ou atenção manual.\r\n\r\n---\r\n\r\n### Tool Guard — Controle de Permissões por Agente\r\n\r\nCada agente tem uma matriz de ferramentas autorizadas. O `tool_guard.py` bloqueia qualquer chamada fora dessa matriz antes que ela seja executada, e registra a tentativa em audit log.\r\n\r\n**Benefícios diretos:**\r\n- Elimina efeitos colaterais acidentais (agente de gestão não consegue escrever código ou executar comandos)\r\n- Audit trail completo de toda ferramenta usada por qualquer agente\r\n- Onboarding seguro: novo agente nasce com permissões mínimas\r\n\r\n```powershell\r\n# Verificar se agente pode usar uma ferramenta\r\npython .agent/scripts/guards/tool_guard.py check delivery-observer Bash\r\n# → ❌ BLOQUEADO — delivery-observer não tem permissão para usar 'Bash'\r\n\r\n# Ver todas as ferramentas de um agente\r\npython .agent/scripts/guards/tool_guard.py list code-author\r\n\r\n# Ver últimas 20 tentativas (incluindo bloqueios)\r\npython .agent/scripts/guards/tool_guard.py audit --last 20\r\n```\r\n\r\n| Tipo de Agente | Ferramentas Autorizadas |\r\n|---|---|\r\n| Produto / Gestão | Read, Grep, Glob |\r\n| Desenvolvimento | Read, Grep, Glob, Bash, Edit, Write |\r\n| Orchestrator | Read, Grep, Glob, Write, Edit, Agent |\r\n| Analistas / QA | Read, Grep, Glob, Write |\r\n| UX / Design | Read, Grep, Glob, Edit, Write, Browser, MCP |\r\n\r\n> Audit log: `.agent/config/.tool_guard_audit.jsonl`\r\n\r\n---\r\n\r\n### Loop Guard — Proteção contra Loops e Rate Limit de APIs\r\n\r\nO `loop_guard.py` detecta quando um agente executa a mesma ação com os mesmos argumentos repetidamente — seja internamente (loop de raciocínio) ou em chamadas a APIs externas.\r\n\r\n**Benefícios diretos:**\r\n- **Protege contra rate limit:** Agentes que chamam Jira, Confluence, ServiceNow ou qualquer API REST repetidamente podem ser banidos por horas. O Loop Guard corta a repetição na 3ª tentativa, antes do bloqueio.\r\n- **Economiza tokens:** Um loop de raciocínio não detectado pode consumir o contexto inteiro sem produzir resultado.\r\n- **Escala ao humano (HITL):** Em vez de falhar silenciosamente, o agente para, documenta o que aconteceu e pede orientação.\r\n\r\n```\r\nIteração 1 → ✅ Normal\r\nIteração 2 → ✅ Normal\r\nIteração 3 → ⚠️ AVISO — \"próxima repetição dispara loop alert\"\r\nIteração 4+ → ❌ LOOP — execução interrompida → escalada ao humano\r\n```\r\n\r\n**Exemplos de loops que o sistema detecta e interrompe:**\r\n\r\n| Padrão detectado | Causa provável | Impacto evitado |\r\n|---|---|---|\r\n| `search_confluence(query)` × 4 | Resposta sem resultado, agente tenta de novo | Rate limit Confluence |\r\n| `create_jira_issue(...)` × 4 | Erro de campo, agente repete sem corrigir | Criação de issues duplicadas |\r\n| `Bash(\"pytest tests/\")` × 4 | Teste falha, agente não altera código | Tokens desperdiçados |\r\n| `get_incident(INC123)` × 4 | ServiceNow lento, agente não aguarda | Bloqueio de IP / 429 |\r\n\r\n```powershell\r\n# Uso programático\r\n# from loop_guard import get_session_tracker, LoopDetectedError\r\n# tracker = get_session_tracker(\"sessao-x\", max_retries=3)\r\n# tracker.record(\"confluence_search\", {\"query\": \"INI-518\"})\r\n# → LoopDetectedError na 4ª chamada → orquestrador para e notifica\r\n```\r\n\r\n> Sessões com mais de **120 minutos** de atividade contínua também acionam alerta automático.\r\n> Audit log: `.agent/config/.loop_guard_audit.jsonl`\r\n\r\n---\r\n\r\n### Session Compressor — Contexto Eficiente em Sessões Longas\r\n\r\nQuando uma sessão acumula muitos artefatos e decisões, a janela de contexto começa a degradar a qualidade das respostas. O `/compress-session` compacta o histórico sem perder rastreabilidade.\r\n\r\n**Benefícios diretos:**\r\n- Sessões longas mantêm coerência e não contradizem decisões anteriores\r\n- Checkpoint salvo em `memories/session/` — retomada rápida após pausa\r\n- Reduz consumo de tokens nas próximas interações\r\n\r\n```\r\n/compress-session\r\n```\r\n\r\nProtocolo executado em 5 passos: identifica decisões → resume artefatos → preserva pendências e bloqueios → salva checkpoint → confirma ao usuário.\r\n\r\n> Skill em: `.agent/skills/session-compressor/SKILL.md`\r\n\r\n---\r\n\r\n### Confidence Scoring — Roteamento com Certeza Calculada\r\n\r\nAntes de delegar qualquer tarefa, o `@project-classifier` calcula um `confidence_score` baseado em 8 evidências objetivas. O `@ivvo-orchestrator` verifica o gate antes de construir o DAG de agentes.\r\n\r\n| Score | Label | Ação |\r\n|---|---|---|\r\n| ≥ 0.85 | HIGH | Prosseguir normalmente |\r\n| 0.70 – 0.84 | MEDIUM | Prosseguir + registrar `confidence_gaps` |\r\n| < 0.70 | LOW | Parar — formular até 3 perguntas de clarificação |\r\n\r\nO `PROJECT_CONTEXT.md` agora inclui os campos `confidence_score`, `confidence_label` e `confidence_gaps`.\r\n\r\n---\r\n\r\n### Context Optimizer — Gestão de Context Window\r\n\r\nO `context_optimizer.py` complementa o Session Compressor com mecanismos automáticos de qualidade de contexto:\r\n\r\n```powershell\r\npython .agent/scripts/ai/context_optimizer.py decay --dry-run # TTL decay (72h / 30 dias)\r\npython .agent/scripts/ai/context_optimizer.py score --query \"login oauth\" # relevância\r\npython .agent/scripts/ai/context_optimizer.py session-check --session-start \"2026-05-14T09:00:00\"\r\npython .agent/scripts/ai/context_optimizer.py report # relatório completo\r\n```\r\n\r\n---\r\n\r\n## Grafo de Conhecimento em Duas Camadas\r\n\r\nO conhecimento do IVVO é organizado em dois bancos SQLite em `.specify/rag/`:\r\n\r\n```\r\nivvo_perene_rag.db ← Verdade universal — não expira (TTL = ∞)\r\n Tipos: symbol, decision, concept, domain, system\r\n Exemplos: domínios Fênix, stack técnica, arquitetura macro, modelo operacional\r\n\r\nivvo_history_rag.db ← Artefatos de projeto — por iniciativa\r\n Tipos: prd, adr, analysis, spec, initiative\r\n Exemplos: PRD INI-518, ADR-001, análise CLOCK02\r\n```\r\n\r\n### Tipos de Nó no Banco Perene\r\n\r\n| Tipo | Cor semântica | Significado |\r\n|---|---|---|\r\n| `root` | Ouro | Nó raiz do programa |\r\n| `universal` | Roxo | Verdade perene / símbolo |\r\n| `project` | Verde | Contexto de iniciativa |\r\n\r\nUse `ivvo_rag.py search \"\" --db perene` para navegar o grafo via CLI.\r\n\r\n---\r\n\r\n## Alinhamento Metodológico\r\n\r\n### SAFe 5\r\n\r\nHierarquia de backlog implementada nativamente:\r\n\r\n```\r\nIniciativa / Projeto\r\n └── Epic (EP-001)\r\n └── Feature (FEAT-001) ← unidade principal do ART Backlog\r\n ├── User Story (US-001) ← unidade de entrega do time\r\n │ └── Task (TASK-001)\r\n └── Enabler (EN-001) ← capacidade técnica/arquitetural\r\n```\r\n\r\n> `Capability (CAP-001)` é usada apenas quando há coordenação real de múltiplos ARTs.\r\n\r\nPriorização via **WSJF**, com suporte a **RICE** e **MoSCoW**.\r\n\r\n### BDD — Critérios de Aceite em Gherkin\r\n\r\n```gherkin\r\nDado \r\nQuando \r\nEntão \r\n```\r\n\r\n### TDD — Trilha Greenfield\r\n\r\nCiclo Red-Green-Refactor: escreva o teste primeiro, depois o código mínimo para passar, depois refatore.\r\n\r\n### Trilhas de Desenvolvimento\r\n\r\n| Aspecto | Greenfield (GF) | Brownfield (BF) |\r\n|---|---|---|\r\n| Ponto de partida | Projeto do zero | Código legado existente |\r\n| Estratégia de testes | TDD-first | Regression-first |\r\n| Arquitetura | Limpa, sem dívida | Strangler Fig gradual |\r\n| Compatibilidade | Sem restrições | Backwards compat obrigatório |\r\n\r\n### Convenção de IDs SAFe\r\n\r\n| Tipo | Prefixo | Exemplo |\r\n|---|---|---|\r\n| Epic | `EP-` | `EP-001` |\r\n| Capability | `CAP-` | `CAP-001` |\r\n| Feature | `FEAT-` | `FEAT-001` |\r\n| Enabler | `EN-` | `EN-001` |\r\n| User Story | `US-` | `US-001` |\r\n| Task | `TASK-` | `TASK-001` |\r\n| ADR | `ADR-` | `ADR-007` |\r\n\r\n---\r\n\r\n## Estrutura do Projeto\r\n\r\n```\r\nivvo-agile-agent/\r\n│\r\n├── .agent/ ← Núcleo do sistema IVVO\r\n│ ├── rules/ ← Regras de comportamento (carregadas automaticamente)\r\n│ ├── agents/ (33 agentes) ← Personas de IA especializadas\r\n│ ├── skills/ (93 skills) ← Módulos de conhecimento\r\n│ ├── workflows/ (40 workflows) ← Slash commands automatizados\r\n│ ├── templates/ ← Templates SAFe (Epic, Feature, Story, ADR...)\r\n│ └── scripts/ ← Scripts de automação\r\n│ ├── ivvo_rag.py ← CLI do sistema de contexto (search/ingest/export/import)\r\n│ ├── ivvo_start.ps1 ← Inicializa a API RAG ao abrir o workspace\r\n│ ├── install_hooks.ps1 ← Instala git hooks (executar 1x após clone)\r\n│ ├── hooks/\r\n│ │ ├── pre-commit ← Bloqueia credenciais em plain-text\r\n│ │ └── post-commit ← Registra evento de commit na telemetria\r\n│ ├── ivvo_contexto.py ← Ingestão de arquivos externos\r\n│ ├── checklist.py ← Validação rápida\r\n│ ├── verify_all.py ← Verificação completa pré-deploy\r\n│ ├── ppt_to_ivvo.py ← Converter documentos para contexto\r\n│ ├── brain_ingest.py ← Ingere conhecimento por domínio\r\n│ ├── tool_guard.py ← Enforcement de permissões por agente (Tool Guard)\r\n│ ├── loop_guard.py ← Detecção de loops e timeout HITL (Loop Guard)\r\n│ ├── guardrail_gate.py ← Gate HITL de autorização para skills CRITICAL/HIGH\r\n│ ├── sql_guard.py ← Enforcer SELECT-only para delivery-observer-sql\r\n│ ├── generate_pptx.py ← Gerador de slides PPTX via python-pptx\r\n│ ├── ivvo_sanitizer.py ← Prompt Injection Defense (obrigatório antes do RAG)\r\n│ ├── ivvo_telemetry.py ← Shim de compatibilidade → ivvo_rag.py telemetry\r\n│ ├── ivvo_runner.py ← Runtime Portability Layer (4 adaptadores: OpenAI, Anthropic, Ollama, Copilot)\r\n│ ├── skill_registry.py ← Dynamic Skill Registry — scan + audit de skills\r\n│ ├── context_optimizer.py ← TTL decay, relevance scoring, session compression check\r\n│ ├── configure_mcp_atlassian.ps1\r\n│ ├── start_mcp_atlassian.ps1\r\n│ └── requirements-ppt.txt\r\n│\r\n├── .specify/ ← Camada de persistência do IVVO Fênix\r\n│ └── rag/ ← 3 bancos SQLite standalone\r\n│ ├── ivvo_perene_rag.db ← Conhecimento permanente (imutável sem senha)\r\n│ ├── ivvo_history_rag.db ← Artefatos de projeto (PRDs, ADRs, análises)\r\n│ ├── ivvo_telemetry.db ← Telemetria de uso\r\n│ └── seed/\r\n│ └── fenix-universal.json ← Seed canônico para regenerar banco perene\r\n│\r\n├── .config/ ← Configuração local (não commitar)\r\n│ └── .venv/ ← Credenciais de integração\r\n│ └── mcp-atlassian.env\r\n│\r\n├── .vscode/ ← Configurações do VS Code\r\n│ ├── settings.json ← Slash commands, rules e task.allowAutomaticTasks\r\n│ ├── tasks.json ← Tasks IVVO (auto-start, export, import, migrate)\r\n│ └── mcp.json\r\n│\r\n├── uploads/ ← Documentos de entrada por contexto\r\n│ └── /\r\n│ ├── canvas/ ← PPTs, briefs, resumos\r\n│ ├── arquitetura/ ← Docs de arquitetura\r\n│ ├── codigos/ ← Swagger, schemas, exemplos\r\n│ └── Recursos/ ← Artefatos IVVO do contexto\r\n│\r\n├── demandas_processadas/ ← Saída oficial dos artefatos gerados\r\n│ └── /\r\n│ ├── upstream/ ← PRD, Brief, Backlog, RAID, Story Map\r\n│ ├── arq/ ← ADRs e diagramas de arquitetura\r\n│ ├── design/ ← Protótipos HTML (condicional)\r\n│ ├── sprints/ ← Planos de sprint\r\n│ ├── testes/ ← Test plans e feature files\r\n│ ├── releases/ ← Release notes e runbooks\r\n│ └── observabilidade/ ← SLOs e runbooks operacionais\r\n│\r\n├── README.md ← Este arquivo\r\n└── .gitignore\r\n```\r\n\r\n---\r\n\r\n## Organização de Artefatos\r\n\r\nTodos os artefatos gerados pelo IVVO vão em `demandas_processadas//` nas subpastas correspondentes.\r\n\r\n### Convenção de Nomenclatura\r\n\r\n| Tipo | Subpasta | Padrão |\r\n|---|---|---|\r\n| PRD, Brief, Backlog, RAID | `upstream/` | `PRD-.md`, `BACKLOG-.md` |\r\n| User Stories | `upstream/` | `US-001-.md` |\r\n| ADRs | `arq/` | `ADR-007-.md` |\r\n| Sprint Plans | `sprints/` | `SPRINT-3.md` |\r\n| Test Plans / Feature Files | `testes/` | `TEST-PLAN-US-001.md`, `US-001.feature` |\r\n\r\n---\r\n\r\n## Instalação e Onboarding\r\n\r\n> Guia completo para qualquer pessoa colocar o IVVO em funcionamento do zero.\r\n\r\n### Pré-requisitos\r\n\r\n| Requisito | Versão mínima | Obrigatório |\r\n|---|---|---|\r\n| **VS Code** | 1.90+ | ✅ Sim |\r\n| **GitHub Copilot** | Assinatura ativa (Individual ou Enterprise) | ✅ Sim |\r\n| **Node.js** | 20.12+ | ✅ Sim (instalador npm) |\r\n| **Python** | 3.10+ | ⚠️ Opcional (scripts de automação) |\r\n| **Git** | qualquer | ✅ Sim |\r\n\r\n### Passo 1 — Instalar via npm (recomendado)\r\n\r\n```bash\r\nnpx @coefenix/ivvo-agent install\r\n```\r\n\r\nO CLI exibe um menu interativo para escolher a IDE, os módulos e o escopo (local ou global). Para instalação silenciosa:\r\n\r\n```bash\r\nnpx @coefenix/ivvo-agent install --yes --tools copilot --modules core,agents-ivvo,workflows,skills\r\n```\r\n\r\n> **Alternativa sem Node.js:** clone o repositório e execute `.\\setup.ps1` — ver seção [Instalação via npm (novo)](#instalação-via-npm-novo).\r\n\r\n### Passo 2 — Abrir no VS Code\r\n\r\n```powershell\r\ncode .\r\n```\r\n\r\nO GitHub Copilot carrega automaticamente os agentes e regras ao abrir o workspace. **Nenhuma configuração adicional é necessária** para começar a usar os comandos slash.\r\n\r\n> Verifique: o ícone do Copilot Chat deve estar ativo na barra lateral do VS Code.\r\n\r\n### Passo 3 — Instalar dependências Python (para conversão de documentos)\r\n\r\n```powershell\r\npip install -r .agent/scripts/requirements-ppt.txt\r\n```\r\n\r\nNecessário apenas se for usar `/contexto-rag` com arquivos `.pptx`, `.docx`, `.pdf` ou `.xlsx`.\r\n\r\n### Passo 4 — Configurar integração Jira + Confluence (opcional)\r\n\r\n> **IMPORTANTE** — Consulte o Administrador IVVO para apoio com essa etapa\r\n\r\nVocê precisará de:\r\n\r\n- **URL** do seu Jira / Confluence\r\n- **Email** Usuário\r\n- **API Token**\r\n\r\nAs credenciais são criptografadas com AES-256-GCM e salvas localmente — nunca vão para o repositório.\r\n\r\n### Passo 5 — Verificar instalação\r\n\r\nAbra o Copilot Chat no VS Code e digite:\r\n\r\n```\r\nQuem é você?\r\n```\r\n\r\nResposta esperada:\r\n> 🤖 *Sou o Sistema de IA IVVO Agile Agent do programa FÊNIX e estou aqui para auxiliar você nas etapas de ciclo de vida de um projeto de Software ou Produto*\r\n\r\n### Primeiros Comandos\r\n\r\n| Comando | O que faz |\r\n|---|---|\r\n| `/create [ideia]` | Discovery completo: Brief → PRD → Backlog → RAID |\r\n| `/story [descrição]` | Cria User Story com ACs em Gherkin + DoR checklist |\r\n| `/sprint --capacity 40` | Planeja sprint com priorização e validação de DoR |\r\n| `/fenix-flow [canvas]` | Fluxo Fênix completo ponta a ponta |\r\n| `/status` | Dashboard de saúde do projeto |\r\n\r\n---\r\n\r\n## Release Notes v2.1.0\r\n\r\n> **Data:** Maio 2026 | **Pacote npm:** [`@coefenix/ivvo-agent`](https://www.npmjs.com/package/@coefenix/ivvo-agent)\r\n\r\n### Instalador CLI npm — Novo mecanismo de distribuição\r\n\r\nO IVVO passa a ser distribuído como **pacote npm**, eliminando a necessidade de clonar o repositório para novos usuários.\r\n\r\n#### O que mudou\r\n\r\n| Antes (v2.0.0) | Agora (v2.1.0) |\r\n|---|---|\r\n| `git clone` do repositório completo | `npx @coefenix/ivvo-agent install` |\r\n| Todos os módulos instalados juntos | Seleção interativa de módulos |\r\n| Apenas VS Code + Copilot | 9 IDEs suportadas (Copilot, Claude Code, Cursor, Codex...) |\r\n| Sem distinção local/global | Escopo local (projeto) ou global (usuário) |\r\n| Atualização via `git pull` | `--update` com SHA-256 preservando customizações |\r\n| Sem canais de versão | Canais `stable` e `next` |\r\n| Sem suporte a CI/CD | Flag `--yes` para instalação não-interativa |\r\n\r\n#### Arquivos adicionados\r\n\r\n| Arquivo | Propósito |\r\n|---|---|\r\n| `package.json` | Definição do pacote npm `@coefenix/ivvo-agent` v2.1.0 |\r\n| `ivvo-modules.yaml` | Registro dos 8 módulos instaláveis |\r\n| `tools/installer/ivvo-cli.js` | Entrypoint do CLI com detecção de nova versão |\r\n| `tools/installer/commands/install.js` | Comando `install` com todas as flags |\r\n| `tools/installer/core/installer.js` | Orquestrador de instalação |\r\n| `tools/installer/core/file-ops.js` | Cópia e sincronização com SHA-256 |\r\n| `tools/installer/ide/platform-codes.yaml` | Caminhos por IDE (9 plataformas) |\r\n| `tools/installer/ide/manager.js` | Configuração automática de `settings.json` e `tasks.json` |\r\n| `tools/installer/prompts.js` | Fluxo interativo com `@clack/prompts` |\r\n| `tools/installer/ui.js` | UI com identidade visual IVVO |\r\n| `tools/installer/install-messages.yaml` | Mensagens pós-instalação por IDE |\r\n| `LICENSE` | Licença MIT |\r\n| `.npmignore` | Exclui `.agent/`, `uploads/`, `.specify/` do pacote publicado |\r\n\r\n#### Como atualizar de v2.0.0 para v2.1.0\r\n\r\n```bash\r\n# Atualização com preservação de customizações locais\r\nnpx @coefenix/ivvo-agent@latest install --update\r\n```\r\n\r\n---\r\n\r\n## Release Notes v2.0.0\r\n\r\n> **Data:** Maio 2026 | **Score de Maturidade Arquitetural:** 8.4 → **10.0 / 10**\r\n\r\n### Resumo das Evoluções\r\n\r\n| Dimensão | v1.x | v2.0 | Ganho |\r\n|---|:---:|:---:|:---:|\r\n| Observabilidade | 6.5 | 10.0 | +3.5 |\r\n| Segurança e Governança | 7.0 | 10.0 | +3.0 |\r\n| Integração / MCP | 7.5 | 10.0 | +2.5 |\r\n| Rastreabilidade | 8.0 | 10.0 | +2.0 |\r\n| Roteamento Inteligente | 8.5 | 10.0 | +1.5 |\r\n| Quality Gates / HITL | 8.5 | 10.0 | +1.5 |\r\n| Modularidade | 9.0 | 10.0 | +1.0 |\r\n| Memória e Contexto | 9.0 | 10.0 | +1.0 |\r\n| Orquestração Multi-Agente | 9.5 | 10.0 | +0.5 |\r\n\r\n### Fase 1 — Segurança e Observabilidade\r\n\r\n- **`ivvo_sanitizer.py`** — Barreira obrigatória contra Prompt Injection antes de qualquer ingestão no RAG. Detecta 13 padrões de ameaça (INJ-001 a INJ-008 + SEN-001 a SEN-005).\r\n- **Credential Governance** — `.gitignore` reforçado + pre-commit hook que bloqueia commits com tokens, passwords e API keys em plain-text.\r\n- **`ivvo_rag.py telemetry`** — Telemetria automática SQLite (`ivvo_telemetry.db`): auto-instrumentada em search/ingest, coleta via VS Code session-start, post-commit hook e Windows Task Scheduler (15 min). Consulta via `ivvo_rag.py telemetry stats`.\r\n\r\n### Fase 2 — Roteamento Inteligente e Quality Gates\r\n\r\n- **Confidence Scoring** — `@project-classifier` calcula `confidence_score` (0.0–1.0) com gate em 3 níveis: HIGH (≥0.85), MEDIUM (0.70–0.84), LOW (<0.70 → para e faz perguntas).\r\n- **`max_retries: 3` + `retry_escalation: hitl`** em 9 agentes principais — escalada automática para o humano na 4ª tentativa.\r\n- **Quality Gates numérico (0–100)** no `@quality-guardian` — substituiu o binário PASS/BLOCKER. Score < 60 bloqueia, 60–79 gera WARNING, ≥80 passa.\r\n- **`ORCHESTRATION_REPORT.md` obrigatório** — toda execução gera audit trail com session ID, agentes, modo, conflitos, artefatos e quality score.\r\n\r\n### Fase 3 — Portabilidade, Modularidade e Contexto\r\n\r\n- **`ivvo_runner.py`** — Runtime Portability Layer com 4 adaptadores: OpenAI, Anthropic, Ollama local e VS Code Copilot. Zero dependências externas.\r\n- **`skill_registry.py`** — Registro dinâmico de 65 skills com lookup semântico por trigger keywords e auditoria de skills órfãos.\r\n- **`context_optimizer.py`** — TTL Decay (72h), Relevance Scoring e Session Compression Check (alerta em sessões > 120min).\r\n\r\n### Scripts Adicionados\r\n\r\n| Script | Propósito |\r\n|---|---|\r\n| `ivvo_sanitizer.py` | Prompt Injection Defense |\r\n| `ivvo_telemetry.py` | Telemetria estruturada JSONL |\r\n| `ivvo_runner.py` | Runtime Portability — 4 adaptadores |\r\n| `skill_registry.py` | Dynamic Skill Registry + audit |\r\n| `context_optimizer.py` | TTL decay + relevance scoring |\r\n| `hooks/pre-commit` | Bloqueia commits com credenciais |\r\n\r\n> Notas completas: [RELEASE-NOTES-v2.0.md](RELEASE-NOTES-v2.0.md)\r\n| Release Notes / Runbooks | `releases/` | `RELEASE-v1.2.0.md`, `RUNBOOK-v1.2.0.md` |\r\n| SLOs | `observabilidade/` | `SLO-.md` |\r\n\r\n### Rastreabilidade\r\n\r\nTodo artefato gerado inclui obrigatoriamente:\r\n\r\n| Referência | Formato |\r\n|---|---|\r\n| Story | `US-XXX` (ex: `US-042`) |\r\n| Critério de Aceite | `AC-N` (ex: `AC-3`) |\r\n| ADR vinculado | `ADR-XXX` (ex: `ADR-007`) |\r\n\r\n---\r\n\r\n## Memória e Contexto\r\n\r\n### Persistência (.specify/rag/)\r\n\r\nO IVVO mantém contexto entre sessões em 3 bancos SQLite standalone:\r\n\r\n| Banco | Conteúdo |\r\n|---|---|\r\n| `.specify/rag/ivvo_perene_rag.db` | Conhecimento permanente do Programa Fênix (imutável sem senha) |\r\n| `.specify/rag/ivvo_history_rag.db` | Artefatos de projeto: PRDs, ADRs, análises, iniciativas |\r\n| `.specify/rag/ivvo_telemetry.db` | Telemetria de uso por sessão e usuário |\r\n\r\nArtefatos de saída (PRDs, backlogs, ADRs) vão em `_outputs//`.\r\nApós geração, ingerir no history RAG com `ivvo_rag.py history ingest`.\r\n\r\n### Sistema de Contexto (RAG)\r\n\r\nBusca semântica em artefatos e decisões anteriores:\r\n\r\n```powershell\r\n# Buscar contexto antes de gerar artefatos\r\npython .agent/scripts/ai/ivvo_rag.py search \"termos da demanda\" --limit 5\r\n\r\n# Buscar somente no banco perene\r\npython .agent/scripts/ai/ivvo_rag.py search \"termos\" --db perene --limit 5\r\n\r\n# Buscar no history (PRDs, ADRs, análises)\r\npython .agent/scripts/ai/ivvo_rag.py history search \"termos\" --type adr\r\n\r\n# Ingerir artefato no history após criá-lo\r\npython .agent/scripts/ai/ivvo_rag.py history ingest --title \"...\" --type prd --domains \"vender\" --file \r\n\r\n# Ingerir arquivo externo no contexto do projeto\r\npython .agent/scripts/ai/ivvo_contexto.py --file --context \r\n\r\n# Verificar status dos bancos RAG\r\npython .agent/scripts/ai/ivvo_rag.py status\r\n```\r\n\r\n### Contexto por Projeto (uploads/)\r\n\r\nOrganize os materiais de entrada em `uploads//`:\r\n\r\n```\r\nuploads/meu-projeto/\r\n├── canvas/ ← PPTs, briefs convertidos\r\n├── arquitetura/ ← Docs de arquitetura, diagramas\r\n├── codigos/ ← Swagger, schemas, exemplos\r\n└── Recursos/\r\n └── PROJECT_CONTEXT.md ← Resumo do projeto para os agentes\r\n```\r\n\r\n### Scripts de Manutenção\r\n\r\n```powershell\r\n# Ingerir conhecimento por domínio no banco perene (requer senha)\r\npython .agent/scripts/ai/brain_ingest.py --input --domain ARQUITETURA --context \r\n\r\n# Reconciliar artefatos recentes com o RAG history\r\n/memory-refresh --context \r\n```\r\n\r\n---\r\n\r\n## IVVO Context Engine — Arquitetura RAG\r\n\r\nO IVVO usa **3 bancos SQLite/FTS5 standalone** em `.specify/rag/`. Não há API local — os scripts Python acessam os bancos diretamente.\r\n\r\n### Bancos e responsabilidades\r\n\r\n| Banco | Tipo | Proteção |\r\n|---|---|---|\r\n| `ivvo_perene_rag.db` | Conhecimento permanente do Programa Fênix | Escrita exige senha (`Fenix@2026`) |\r\n| `ivvo_history_rag.db` | Artefatos de projeto (PRDs, ADRs, análises, INIs) | Livre para leitura e escrita |\r\n| `ivvo_telemetry.db` | Telemetria de uso por sessão e usuário | Automático |\r\n\r\n### Setup em nova máquina (executar 1x)\r\n\r\n```powershell\r\n# 1. Clonar e abrir no VS Code normalmente\r\ngit clone https://github.com/COEFENIX/ivvo-fenix.git\r\ncd ivvo-fenix\r\n\r\n# 2. Instalar dependências Python\r\npip install -r requirements.txt\r\n\r\n# 3. Instalar git hooks e inicializar bancos\r\n.agent/scripts/infra/install_hooks.ps1\r\n\r\n# 4. Seed do banco perene (carrega conhecimento base do Fênix)\r\npython .agent/scripts/ai/ivvo_rag.py migrate\r\n```\r\n\r\n### Tasks VS Code disponíveis\r\n\r\nAcesse via `Ctrl+Shift+P` → **Tasks: Run Task**:\r\n\r\n| Task | O que faz |\r\n|---|---|\r\n| `IVVO: Start Context Engine` | Inicializa bancos RAG e verifica integridade |\r\n| `IVVO: Rebuild RAG Index (migrate)` | Reprocessa seed e reindexar bancos |\r\n| `IVVO: Status` | Exibe contagem de nós por banco |\r\n\r\n### Arquivos versionados vs. ignorados\r\n\r\n| Arquivo | Versionado? | Motivo |\r\n|---|---|---|\r\n| `.specify/rag/seed/fenix-universal.json` | ✅ Sim | Seed canônico para regenerar banco perene |\r\n| `.specify/rag/*.db` | ❌ Não | Bancos SQLite locais (binários) |\r\n\r\n### Operação manual do RAG\r\n\r\n```powershell\r\n# Verificar status dos 3 bancos\r\npython .agent/scripts/ai/ivvo_rag.py status\r\n\r\n# Reconstruir bancos a partir do seed\r\npython .agent/scripts/ai/ivvo_rag.py migrate\r\n\r\n# Ingerir artefato de projeto no history\r\npython .agent/scripts/ai/ivvo_rag.py history ingest --title \"PRD INI-518\" --type prd --domains \"vender\" --file _outputs/ini-518/upstream/PRD.md\r\n```\r\n\r\n---\r\n\r\n### Reutilizando o Contexto RAG em Outro VS Code / Outra Sessão\r\n\r\n> **Cenário:** Você está em uma máquina diferente e quer ter o mesmo contexto de RAG da sessão anterior.\r\n\r\nOs bancos SQLite são locais e não são versionados. Para transferir contexto:\r\n\r\n```powershell\r\n# Opção 1 — Copiar os bancos manualmente (mesma máquina, novo workspace)\r\ncp .specify/rag/*.db /.specify/rag/\r\n\r\n# Opção 2 — Reconstruir o banco perene a partir do seed\r\npython .agent/scripts/ai/ivvo_rag.py migrate\r\n\r\n# Opção 3 — Re-ingerir artefatos de _outputs/ no history\r\npython .agent/scripts/ai/ivvo_rag.py history ingest --title \"...\" --type prd --domains \"...\" --file _outputs/...\r\n\r\n# Verificar estado após restauração\r\npython .agent/scripts/ai/ivvo_rag.py status\r\n```\r\n\r\n---\r\n\r\n## Gate de Qualidade e DoD\r\n\r\nAntes de marcar qualquer item como **Done**: invocar `@quality-guardian`. O gate deve retornar **✅ PASS** sem BLOCKERs — não há exceções.\r\n\r\n### Níveis de DoD\r\n\r\n| Nível | Critérios |\r\n|---|---|\r\n| **Story** | ACs 100% cobertos + testes passando + code review aprovado |\r\n| **Sprint** | Todas as stories com DoD Story + Demo realizada |\r\n| **Release** | Todas as sprints com DoD Sprint + runbook + smoke test |\r\n\r\n### Resultado do Gate\r\n\r\n| Status | Ação |\r\n|---|---|\r\n| ✅ PASS | Pode avançar |\r\n| ⚠️ WARNING | Avançar com ciência do risco registrada |\r\n| ❌ BLOCKER | **Não pode avançar** |\r\n\r\n---\r\n\r\n## Idioma\r\n\r\n| Elemento | Idioma |\r\n|---|---|\r\n| Respostas dos agentes | **Português Brasileiro (PT-BR)** |\r\n| Artefatos (backlog, PRD, ADR, testes, releases...) | **Português Brasileiro (PT-BR)** |\r\n| Código-fonte (variáveis, funções, classes, comentários) | **Inglês** |\r\n| Nomes de arquivos e IDs | **Inglês** (`US-001`, `FEAT-007`) |\r\n| Gherkin | **Português** (Dado/Quando/Então) |\r\n\r\n---\r\n\r\n## Glossário\r\n\r\n| Termo / Sigla | Significado |\r\n|---|---|\r\n| **AC** | *Acceptance Criteria* — Critérios de aceite em formato Gherkin |\r\n| **ADR** | *Architecture Decision Record* — Registro de decisão técnica versionado |\r\n| **ART** | *Agile Release Train* — Conjunto de equipes SAFe em torno de uma solução |\r\n| **BDD** | *Behavior-Driven Development* — Desenvolvimento orientado a comportamento |\r\n| **Brief** | Documento que resume o problema, para quem e o valor entregue |\r\n| **Brownfield (BF)** | Projeto com código legado existente |\r\n| **CHG / GMUD** | Gestão de Mudança corporativa |\r\n| **DoD** | *Definition of Done* — Checklist para concluir um item |\r\n| **DoR** | *Definition of Ready* — Critérios para entrar no sprint |\r\n| **DORA** | 4 métricas de entrega: frequência de deploy, lead time, CFR, MTTR |\r\n| **Enabler** | Item SAFe de capacidade técnica/arquitetural — não é Feature de negócio |\r\n| **Epic** | Unidade SAFe estratégica com Lean Business Case |\r\n| **Feature** | Principal item planejável do ART Backlog |\r\n| **Gherkin** | Linguagem de ACs: Dado/Quando/Então |\r\n| **Greenfield (GF)** | Projeto do zero — TDD, arquitetura limpa |\r\n| **INVEST** | Critérios de boa story: Independent, Negotiable, Valuable, Estimable, Small, Testable |\r\n| **MCP** | *Model Context Protocol* — Integração de ferramentas externas com o Copilot |\r\n| **MTTR** | *Mean Time to Recovery* — Tempo médio de recuperação após incidente |\r\n| **PRD** | *Product Requirements Document* — Contrato produto ↔ desenvolvimento |\r\n| **RAID** | Risks, Assumptions, Issues, Dependencies |\r\n| **RAG** | *Retrieval-Augmented Generation* — Busca semântica em artefatos existentes |\r\n| **RFC** | *Request for Comments* — Proposta de mudança técnica aberta à discussão |\r\n| **SAFe** | *Scaled Agile Framework* — Framework ágil para equipes e programas |\r\n| **SLO** | *Service Level Objective* — Meta mensurável de disponibilidade ou performance |\r\n| **Slug** | Identificador curto em kebab-case de um contexto/projeto (ex: `ini-420-pix-automatico`) |\r\n| **SPTI** | Solicitação de Projeto de Tecnologia da Informação (governança corporativa) |\r\n| **TDD** | *Test-Driven Development* — Desenvolvimento guiado por testes |\r\n| **WSJF** | *Weighted Shortest Job First* — Método de priorização SAFe |\r\n\r\n---\r\n\r\n
\r\n\r\n**IVVO AgileAgent** \r\n_Acelerando o desenvolvimento de software com IA._\r\n\r\n
\r\n","readmeFilename":"README.md"}