{"_id":"@1c2c/agent-templates","_rev":"2-a25bfa849c7fe93f4adf2159925ae495","name":"@1c2c/agent-templates","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@1c2c/agent-templates","version":"0.1.0","keywords":["agents","claude","cursor","octc","1click2control","acp","agent-capability-provider"],"license":"MIT","_id":"@1c2c/agent-templates@0.1.0","maintainers":[{"name":"1click2control","email":"fernando.flechas@1click2control.com"}],"homepage":"https://github.com/OneClickToControl/octc-platform/tree/main/packages/agent-templates#readme","bugs":{"url":"https://github.com/OneClickToControl/octc-platform/issues"},"bin":{"octc-agents":"bin/octc-agents.mjs"},"dist":{"shasum":"214df83982723c9365d9d9760594d3075ea9908c","tarball":"https://registry.npmjs.org/@1c2c/agent-templates/-/agent-templates-0.1.0.tgz","fileCount":10,"integrity":"sha512-j/dvWEctv2+9tBUMGTbXHQCNx9+cus44Q/NpXbwcS7w1Kbw3lQgxRV5Js449zq8N8kShsamjMF6AhVe/14jMEA==","signatures":[{"sig":"MEQCIDVSM1CxtibXyTNOjWhukx8DsZ7t2plE/QtLdbo17Jn1AiALaCViEjhfA0KEYkAhR4AaFjwMJzcUT5r+W5MMqs2zOw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25519},"type":"module","exports":{".":"./index.mjs","./schema":"./schemas/octc-agent-provider.manifest.v1.json","./templates":"./templates/index.mjs","./templates/agents":"./templates/AGENTS.md","./templates/claude":"./templates/CLAUDE.md","./templates/cursor/base":"./templates/cursor/00-octc-base.mdc","./templates/cursor/tooling":"./templates/cursor/01-octc-tooling.mdc"},"gitHead":"e1f579aba7a0c42718a0b5b2121e0312e89b756e","scripts":{"test":"node --test test/*.test.mjs","build":"node ./scripts/sync-from-ssot.mjs","prepack":"npm run build"},"_npmUser":{"name":"1click2control","email":"fernando.flechas@1click2control.com"},"repository":{"url":"git+https://github.com/OneClickToControl/octc-platform.git","type":"git","directory":"packages/agent-templates"},"_npmVersion":"11.6.2","description":"Canonical agent templates (CLAUDE.md, AGENTS.md, Cursor rules, ACP manifest schema) for OneClickToControl LLC repos.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"y":"^0.3.2"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/agent-templates_0.1.0_1777500764628_0.6331685802976021","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@1c2c/agent-templates","version":"0.2.0","description":"Canonical agent templates (CLAUDE.md, AGENTS.md, Cursor rules, ACP manifest schema) for OneClickToControl LLC repos.","license":"MIT","type":"module","publishConfig":{"access":"public","provenance":true},"repository":{"type":"git","url":"git+https://github.com/OneClickToControl/octc-platform.git","directory":"packages/agent-templates"},"homepage":"https://github.com/OneClickToControl/octc-platform/tree/main/packages/agent-templates#readme","bin":{"octc-agents":"bin/octc-agents.mjs"},"exports":{".":"./index.mjs","./schema":"./schemas/octc-agent-provider.manifest.v1.json","./templates":"./templates/index.mjs","./templates/claude":"./templates/CLAUDE.md","./templates/agents":"./templates/AGENTS.md","./templates/cursor/base":"./templates/cursor/00-octc-base.mdc","./templates/cursor/tooling":"./templates/cursor/01-octc-tooling.mdc"},"keywords":["agents","claude","cursor","octc","1click2control","acp","agent-capability-provider"],"devDependencies":{"vitest":"^4.1.8"},"scripts":{"build":"node ./scripts/sync-from-ssot.mjs","test":"vitest run"},"_id":"@1c2c/agent-templates@0.2.0","bugs":{"url":"https://github.com/OneClickToControl/octc-platform/issues"},"_integrity":"sha512-o+rZZzYCR886fjrrn+cZ9JfRRkUswZjrx6bNyp9zFIweUT59Wf9evOpVYq/WXDmdXEpeYjPMebnqSBzH2S/giQ==","_resolved":"/tmp/de288cf99cd32ba9e5cd1ff657265c7f/1c2c-agent-templates-0.2.0.tgz","_from":"file:1c2c-agent-templates-0.2.0.tgz","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-o+rZZzYCR886fjrrn+cZ9JfRRkUswZjrx6bNyp9zFIweUT59Wf9evOpVYq/WXDmdXEpeYjPMebnqSBzH2S/giQ==","shasum":"b118f699d0ff0f9977eae00534b522c94d1f876d","tarball":"https://registry.npmjs.org/@1c2c/agent-templates/-/agent-templates-0.2.0.tgz","fileCount":11,"unpackedSize":27502,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@1c2c%2fagent-templates@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEgBqUgZWMUBB+TwkA04TuEr9SBZeiJ2y7P1CU7DicWhAiAvfKh8SqPDvH2GYgT+15JEmkjQpx+jMrGyYao/q9w1pw=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2973ca85-461f-4764-b107-17c3c8bf1881"}},"directories":{},"maintainers":[{"name":"1click2control","email":"fernando.flechas@1click2control.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent-templates_0.2.0_1780928907217_0.1948571364429612"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-29T22:12:44.530Z","modified":"2026-06-08T14:28:27.706Z","0.1.0":"2026-04-29T22:12:44.785Z","0.2.0":"2026-06-08T14:28:27.394Z"},"bugs":{"url":"https://github.com/OneClickToControl/octc-platform/issues"},"license":"MIT","homepage":"https://github.com/OneClickToControl/octc-platform/tree/main/packages/agent-templates#readme","keywords":["agents","claude","cursor","octc","1click2control","acp","agent-capability-provider"],"repository":{"type":"git","url":"git+https://github.com/OneClickToControl/octc-platform.git","directory":"packages/agent-templates"},"description":"Canonical agent templates (CLAUDE.md, AGENTS.md, Cursor rules, ACP manifest schema) for OneClickToControl LLC repos.","maintainers":[{"name":"1click2control","email":"fernando.flechas@1click2control.com"}],"readme":"# @1c2c/agent-templates\n\nCanonical agent templates (`CLAUDE.md`, `AGENTS.md`, Cursor rules) and the ACP manifest schema for OneClickToControl LLC repos.\n\nThis package mirrors the SSOT in [`octc-platform`](https://github.com/OneClickToControl/octc-platform) under `templates/agents/` and `schemas/`. Repos consume it to scaffold and keep their agent templates drift-free against the platform baseline.\n\n## Install\n\n```bash\npnpm add -D @1c2c/agent-templates\n```\n\nOr invoke the CLI directly without installing:\n\n```bash\nnpx @1c2c/agent-templates init\n```\n\n## What's inside\n\n| File                                         | Purpose                                                                                          |\n| -------------------------------------------- | ------------------------------------------------------------------------------------------------ |\n| `templates/CLAUDE.md`                        | Normative base for Claude-family agents. Contains `<!-- octc:base ... -->` markers.              |\n| `templates/AGENTS.md`                        | Neutral equivalent for Cursor / OpenAI / other coding agents.                                    |\n| `templates/cursor/00-octc-base.mdc`          | Cursor rule with the always-applied platform baseline.                                           |\n| `templates/cursor/01-octc-tooling.mdc`       | Cursor rule that codifies the platform tooling (TS, ESLint, pnpm, Conventional Commits).         |\n| `schemas/octc-agent-provider.manifest.v1.json` | JSON Schema (draft 2020-12) for the ACP manifest validated by `verify.yml`.                    |\n\n## CLI\n\nThe package exposes a binary `octc-agents`.\n\nFor the unified **`octc`** CLI (install with **`pnpm add -D @1c2c/cli`**, includes `octc sync agents` and monorepo commands on **` *-app`** repos), use [`@1c2c/cli`](../cli); for template-only paths delegate here (`octc-agents`).\n\n```bash\n# scaffold the canonical files in the current repo\nnpx @1c2c/agent-templates init\n\n# scaffold into a specific dir, overwriting any existing copy\nnpx @1c2c/agent-templates init --target ./my-repo --force\n\n# report drift versus the canonical version (exits 1 on drift)\nnpx @1c2c/agent-templates verify\n\n# update drifted files; markdown files keep your <!-- octc:user --> blocks\nnpx @1c2c/agent-templates sync\n```\n\n`init` writes:\n\n```\n<target>/CLAUDE.md\n<target>/AGENTS.md\n<target>/.cursor/rules/00-octc-base.mdc\n<target>/.cursor/rules/01-octc-tooling.mdc\n<target>/.octc/agents/manifest.schema.json\n```\n\n`sync` rewrites only the `<!-- octc:base ... -->` block of `CLAUDE.md` and `AGENTS.md`, preserving any local edits inside `<!-- octc:user --> ... <!-- octc:end-user -->`.\n\n## Programmatic API\n\n```js\nimport { templates, schemas, VERSION } from \"@1c2c/agent-templates\";\n\nconst claudeMd = templates.claude();\nconst agentsMd = templates.agents();\nconst cursorBase = templates.cursorBase();\nconst cursorTooling = templates.cursorTooling();\nconst acpSchema = schemas.acpManifestV1();\n\nconsole.log(\"agent-templates version:\", VERSION);\n```\n\nYou can also resolve raw file paths via package exports:\n\n```js\nimport { paths } from \"@1c2c/agent-templates/templates\";\n\nconsole.log(paths.claude); // absolute path to CLAUDE.md inside the package\n```\n\nOr import the JSON schema directly:\n\n```js\nimport schema from \"@1c2c/agent-templates/schema\" with { type: \"json\" };\n```\n\n## Provenance\n\nPublished with **npm provenance** via GitHub Actions OIDC (Trusted Publishers). Verify in your CI:\n\n```bash\npnpm dlx audit-signatures || npm audit signatures\n```\n\nThe release run for each version is linked from the corresponding [GitHub Release](https://github.com/OneClickToControl/octc-platform/releases) and the [npm package page](https://www.npmjs.com/package/@1c2c/agent-templates).\n\nSee [`docs/packages/POLICY.md`](../../docs/packages/POLICY.md) for the full supply-chain policy.\n\n## Bootstrap (first manual publish)\n\nIf the package does not exist on npm yet, maintainers may need **one** manual publish before GitHub OIDC / Trusted Publishers can take over.\n\n1. **Git** — Track `main`: `git checkout main && git pull`. If `git pull` complains about a missing remote branch, run `git branch --unset-upstream` then `git branch -u origin/main` (your local branch was probably tied to a deleted feature branch).\n2. **Install** — Run `pnpm install` only from the **monorepo root** (`octc-platform/`). Do not paste inline comments (`# …`) into the shell as part of the command; pnpm may treat `#` as a dependency spec and fail with `ERR_PNPM_SPEC_NOT_SUPPORTED_BY_ANY_RESOLVER`.\n3. **Build & publish path** — From **`packages/agent-templates/`**: `pnpm run build`, then `npm publish --access public`. Do **not** run `npm publish` from the repository root; that targets the private `octc-platform` workspace package.\n4. **Provenance** — `publishConfig.provenance` expects CI (GitHub Actions). On a laptop you will get `EUSAGE` / `provider: null` unless you disable it for that one run:\n\n   ```bash\n   npm publish --access public --no-provenance\n   ```\n\n   (or `NPM_CONFIG_PROVENANCE=false npm publish --access public`, depending on your npm version.)\n5. **Auth** — Set a non-empty token (`export NPM_TOKEN=npm_...`) before `npm config set //registry.npmjs.org/:_authToken \"${NPM_TOKEN}\"`, or use `npm login`.\n\nAfter the package exists, add a **Trusted Publisher** for `@1c2c/agent-templates` in npm (same org/repo as your other `@1c2c/*` packages) and prefer releases from CI only.\n\n## Drift policy\n\nThe single source of truth for these files lives in `octc-platform`:\n\n- `templates/agents/CLAUDE.md`\n- `templates/agents/AGENTS.md`\n- `templates/agents/cursor/*.mdc`\n- `schemas/octc-agent-provider.manifest.v1.json`\n\nThis package mirrors them at build time via `scripts/sync-from-ssot.mjs` (run by `prepack`). The `agent-templates-drift` job in `verify.yml` blocks any PR where the package copy and the SSOT diverge.\n\n## Versioning\n\nStrict SemVer, Changesets-driven. See the **Special case: `@1c2c/agent-templates` versioning** section in [`docs/packages/POLICY.md`](../../docs/packages/POLICY.md):\n\n- **Major** — breaking structural change, removed sections, or anything that breaks tooling that parses the files.\n- **Minor** — new sections, additional non-breaking rules, support for new runtimes.\n- **Patch** — wording fixes, examples, typos.\n","readmeFilename":"README.md"}