{"_id":"@cardosoads/harnesskit","name":"@cardosoads/harnesskit","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.3":{"name":"@cardosoads/harnesskit","version":"0.1.3","description":"Harness-first agent workflow scaffold for software projects.","type":"module","private":false,"publishConfig":{"access":"public"},"keywords":["agents","harness","spec-driven","workflow","ai"],"bin":{"harnesskit":"bin/harnesskit.mjs"},"scripts":{"harnesskit":"node bin/harnesskit.mjs","validate":"bash .harnesskit/scripts/validate.sh","test":"bash .harnesskit/scripts/validate.sh && bash .harnesskit/scripts/harness-selftest.sh","pack:check":"node scripts/check-package-files.mjs"},"engines":{"node":">=18"},"license":"MIT","repository":{"type":"git","url":"git+ssh://git@github.com/cardosoads/harnesskit.git"},"homepage":"https://github.com/cardosoads/harnesskit#readme","bugs":{"url":"https://github.com/cardosoads/harnesskit/issues"},"dependencies":{"ajv-cli":"5.0.0"},"gitHead":"9fea75e4ab25adad2fae338008b048311f17ba1a","_id":"@cardosoads/harnesskit@0.1.3","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-CbYziWVuBE8WBXextR6YVDTgfoWSqvwy56p+F+LJRQzFLCQgi4b0fHYVqS9m+cE+SNwVVeekm1C3jILg/imuoQ==","shasum":"8914123164119e2bf13fac6b0da4e782d7dda216","tarball":"https://registry.npmjs.org/@cardosoads/harnesskit/-/harnesskit-0.1.3.tgz","fileCount":136,"unpackedSize":582981,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCU4uK4Kr7tnTeBBCV6HFrVqpXpNjqxtlPGniIysBy7pAIhANVwIfLTBmK6XpagG2bxzqLroxDGLAZ3KVjE845y/m4b"}]},"_npmUser":{"name":"cardosoads","email":"cardoso.tads@gmail.com"},"directories":{},"maintainers":[{"name":"cardosoads","email":"cardoso.tads@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/harnesskit_0.1.3_1776096401083_0.34369712108663886"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T16:06:40.990Z","0.1.3":"2026-04-13T16:06:41.254Z","modified":"2026-04-13T16:06:41.458Z"},"maintainers":[{"name":"cardosoads","email":"cardoso.tads@gmail.com"}],"description":"Harness-first agent workflow scaffold for software projects.","homepage":"https://github.com/cardosoads/harnesskit#readme","keywords":["agents","harness","spec-driven","workflow","ai"],"repository":{"type":"git","url":"git+ssh://git@github.com/cardosoads/harnesskit.git"},"bugs":{"url":"https://github.com/cardosoads/harnesskit/issues"},"license":"MIT","readme":"# Harnesskit\n\nHarnesskit is a Harness-first workflow scaffold for agentic software projects.\nIt gives a project a visible process, durable artifacts, verifiable contracts,\nand feedback sensors so users can see where they are and what should happen\nnext.\n\n## Install In A Project\n\n```bash\nnpx @cardosoads/harnesskit@latest init\n```\n\nFor scripted setup:\n\n```bash\nnpx @cardosoads/harnesskit@latest init --type feature-work --name my-project\nnpx @cardosoads/harnesskit@latest init --type existing-system --name legacy-app\nnpx @cardosoads/harnesskit@latest init --type new-product --name new-app\n```\n\nFor non-interactive defaults:\n\n```bash\nnpx @cardosoads/harnesskit@latest init --yes --name my-project\n```\n\n## Project Tracks\n\n| User-facing name | Internal ID | Use when |\n| --- | --- | --- |\n| `new-product` | `greenfield` | You are starting a project from zero. |\n| `existing-system` | `brownfield` | You are improving, refactoring, or analyzing an existing project. |\n| `feature-work` | `new-features` | You are adding a feature to an existing project. |\n\nInternal IDs are kept for compatibility with existing Harnesskit workflows.\n\n## Daily Commands\n\n```bash\nnpx @cardosoads/harnesskit@latest status\nnpx @cardosoads/harnesskit@latest next\nnpx @cardosoads/harnesskit@latest codex\nnpx @cardosoads/harnesskit@latest doctor\nnpx @cardosoads/harnesskit@latest validate\nnpx @cardosoads/harnesskit@latest contract \"describe the work unit\"\n```\n\n`harnesskit status` explains the current phase, progress, active Harness\ncontracts, and next pending step. `harnesskit next` recommends the next action.\n`harnesskit codex` prints a Codex-ready route with shell commands and the\nprompt to give the agent.\n\nFor non-trivial implementation work, use the Harness loop:\n\n```text\nSheldon -> Leslie contract -> Howard implementation -> sensors -> Amy review\n```\n\n## Slash Commands\n\nClaude Code slash commands live in `.claude/commands/`. When using an agent\nenvironment that reads those files, the scaffold adds:\n\n- `/harnesskit-status`\n- `/harnesskit-next`\n- `/harnesskit-doctor`\n- `/harnesskit-contract`\n\nCodex does not use those Claude Code slash commands. In Codex, tell the agent to\nread `AGENTS.md`, then run the shell flow:\n\n```bash\nnpx @cardosoads/harnesskit@latest codex\n```\n\nHarnesskit agents are instruction files in `.harnesskit/core/agents/`; they\nare not separate local processes that Codex has to execute.\n\n## Package Checks\n\n```bash\nnpm test\nnpm run pack:check\n```\n\n`pack:check` should not include local development artifacts, completed\ncontracts, evaluations, or Python cache files.\n","readmeFilename":"README.md","_rev":"1-61a7c7e57bbc0f91508a4de9a86d01f8"}