{"_id":"@codecell-germany/company-agent-wiki-skill","_rev":"6-a9a569ca11dff6443d8453cdad7b26df","name":"@codecell-germany/company-agent-wiki-skill","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.0":{"name":"@codecell-germany/company-agent-wiki-skill","version":"0.1.0","license":"MIT","_id":"@codecell-germany/company-agent-wiki-skill@0.1.0","maintainers":[{"name":"codecell-germany","email":"admin@codecell.de"}],"bin":{"company-agent-wiki-cli":"dist/index.js","company-agent-wiki-skill":"dist/installer.js"},"dist":{"shasum":"91aaf8566e64f8b25aa3751799ebcaecbad875f0","tarball":"https://registry.npmjs.org/@codecell-germany/company-agent-wiki-skill/-/company-agent-wiki-skill-0.1.0.tgz","fileCount":15,"integrity":"sha512-5ujZvHQVRoMAcMr290UPb3WoyHUXF/o7KYEhwXGMPCj53vKNdEtKalcn5xNTBLUq7JxirDfWf8C0MvhY5sOBxA==","signatures":[{"sig":"MEUCIDUu4s1rMoOxeKmu2mBz3UIGGL+awYLoYInaGhxTXY5yAiEAqG7OLdLgeUd9q6rOkRZ/q6abDIQKD8/Sas0cfoVjDqI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":631114},"main":"dist/index.js","type":"commonjs","engines":{"node":">=20.10"},"gitHead":"a243968bf32211f9fdc9fbec28e903f5cfefe664","private":false,"scripts":{"test":"npm run test:unit","build":"npm run clean && npm run typecheck && node scripts/build.mjs","clean":"rm -rf dist coverage","test:unit":"vitest run","typecheck":"tsc --noEmit"},"_npmUser":{"name":"codecell-germany","email":"admin@codecell.de"},"_npmVersion":"11.12.1","description":"Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a Codex skill installer.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"better-sqlite3":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"marked":"^15.0.12","vitest":"^3.1.2","esbuild":"^0.25.3","commander":"^14.0.0","typescript":"^5.8.3","@types/node":"^22.15.3","gray-matter":"^4.0.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/company-agent-wiki-skill_0.1.0_1776064125628_0.42175575488080064","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@codecell-germany/company-agent-wiki-skill","version":"0.1.1","license":"MIT","_id":"@codecell-germany/company-agent-wiki-skill@0.1.1","maintainers":[{"name":"codecell-germany","email":"admin@codecell.de"}],"bin":{"company-agent-wiki-cli":"dist/index.js","company-agent-wiki-skill":"dist/installer.js"},"dist":{"shasum":"75d563ab3cc71714edf2375fa878912d0c83aa74","tarball":"https://registry.npmjs.org/@codecell-germany/company-agent-wiki-skill/-/company-agent-wiki-skill-0.1.1.tgz","fileCount":15,"integrity":"sha512-AjlICRwyPOjTNX/Mq7mSSVYOSpTDqO5Fr49GHXdJAkcLWYe2OJIv4GqHxhHgvJV3Op37DmDliEjj5NFyYjRS7w==","signatures":[{"sig":"MEQCIDflc6ldir4wc03tnpNxKOCsvTUTXPMvIMLxCcWCsXyjAiBiwgVGs564K/t5Qb+hvTNuG5tyD9/fboOELX1b5smPWg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":652466},"main":"dist/index.js","type":"commonjs","engines":{"node":">=20.10"},"gitHead":"e0039959818cd4e4a7ab97dd783c718cfee58564","private":false,"scripts":{"test":"npm run test:unit","build":"npm run clean && npm run typecheck && node scripts/build.mjs","clean":"rm -rf dist coverage","test:unit":"vitest run","typecheck":"tsc --noEmit"},"_npmUser":{"name":"codecell-germany","email":"admin@codecell.de"},"_npmVersion":"11.12.1","description":"Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a Codex skill installer.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"better-sqlite3":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"marked":"^15.0.12","vitest":"^3.1.2","esbuild":"^0.25.3","commander":"^14.0.0","typescript":"^5.8.3","@types/node":"^22.15.3","gray-matter":"^4.0.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/company-agent-wiki-skill_0.1.1_1776065251949_0.16308396636903333","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codecell-germany/company-agent-wiki-skill","version":"0.1.2","license":"MIT","_id":"@codecell-germany/company-agent-wiki-skill@0.1.2","maintainers":[{"name":"codecell-germany","email":"admin@codecell.de"}],"bin":{"company-agent-wiki-cli":"dist/index.js","company-agent-wiki-skill":"dist/installer.js"},"dist":{"shasum":"1c95a1900c9683f97e3662ce9a38127a60f41d84","tarball":"https://registry.npmjs.org/@codecell-germany/company-agent-wiki-skill/-/company-agent-wiki-skill-0.1.2.tgz","fileCount":15,"integrity":"sha512-xOB/ba0vvTi01gBua+VPHA81G6eFzMCxfI/fK4sVFCsIMJZmY64yNJS09b+Pdas/YvYrNAksZvaFDw4Acml2SQ==","signatures":[{"sig":"MEQCIBtnc3XYZ2SeqajEvY/jH2Ilgo56GwhxGyFVaez4PVysAiBEXwnWP3q5TKPcEtw9ffzWdZvtyFzyTxawdz25Ppwe3w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":650746},"main":"dist/index.js","type":"commonjs","engines":{"node":">=20.10"},"gitHead":"07ca91173ba4ba60cd56f438866e58a9dd402887","private":false,"scripts":{"test":"npm run test:unit","build":"npm run clean && npm run typecheck && node scripts/build.mjs","clean":"rm -rf dist coverage","test:unit":"vitest run","typecheck":"tsc --noEmit"},"_npmUser":{"name":"codecell-germany","email":"admin@codecell.de"},"_npmVersion":"11.12.1","description":"Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a Codex skill installer.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"better-sqlite3":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"marked":"^15.0.12","vitest":"^3.1.2","esbuild":"^0.25.3","commander":"^14.0.0","typescript":"^5.8.3","@types/node":"^22.15.3","gray-matter":"^4.0.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/company-agent-wiki-skill_0.1.2_1776073060399_0.09844976516960458","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@codecell-germany/company-agent-wiki-skill","version":"0.1.3","license":"MIT","_id":"@codecell-germany/company-agent-wiki-skill@0.1.3","maintainers":[{"name":"codecell-germany","email":"admin@codecell.de"}],"bin":{"company-agent-wiki-cli":"dist/index.js","company-agent-wiki-skill":"dist/installer.js"},"dist":{"shasum":"d767bde6c18a1c35e92ccd73691c2c0d4c83c330","tarball":"https://registry.npmjs.org/@codecell-germany/company-agent-wiki-skill/-/company-agent-wiki-skill-0.1.3.tgz","fileCount":15,"integrity":"sha512-0YdVEVrrNmzLirypqBtNhBwoZAVbJ80RJXnuDMpNOPFJMQNuoG43lbh+ruiYZgSV/CPM5grnYxOB5+eG4v4P2g==","signatures":[{"sig":"MEUCIQCPnY1LWhQeMuotXm0ilfGPs8xnwam8pl00QytIDLKxCwIgAJVPIaYia161/4eQtQHLePxFz1l/5cS6K8uCCpjeMYo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":656634},"main":"dist/index.js","type":"commonjs","engines":{"node":">=20.10"},"gitHead":"da997505f5d0e3144075f8b88578d18702b5df95","private":false,"scripts":{"test":"npm run test:unit","build":"npm run clean && npm run typecheck && node scripts/build.mjs","clean":"rm -rf dist coverage","test:unit":"vitest run","typecheck":"tsc --noEmit"},"_npmUser":{"name":"codecell-germany","email":"admin@codecell.de"},"_npmVersion":"11.12.1","description":"Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a shared agent skill installer.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"better-sqlite3":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"marked":"^15.0.12","vitest":"^3.1.2","esbuild":"^0.25.3","commander":"^14.0.0","typescript":"^5.8.3","@types/node":"^22.15.3","gray-matter":"^4.0.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/company-agent-wiki-skill_0.1.3_1776076191117_0.7984726276814531","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@codecell-germany/company-agent-wiki-skill","version":"0.1.4","license":"MIT","_id":"@codecell-germany/company-agent-wiki-skill@0.1.4","maintainers":[{"name":"codecell-germany","email":"admin@codecell.de"}],"bin":{"company-agent-wiki-cli":"dist/index.js","company-agent-wiki-skill":"dist/installer.js"},"dist":{"shasum":"dd75db8b34c9abcd512e70a04a79a4414a2ccff4","tarball":"https://registry.npmjs.org/@codecell-germany/company-agent-wiki-skill/-/company-agent-wiki-skill-0.1.4.tgz","fileCount":15,"integrity":"sha512-ebmg9klZ3sO1L4YuZJISwwGQmV97ZfMjHZk/uIl0JCxm5K1ZpCfjURqEKHVxuMyNNRYdT0r8C3vEaYrJjZSVhQ==","signatures":[{"sig":"MEQCIAz6mWVPlZfuBr6e17lNaIYDfv0XJQTv/JocCzGi/4KUAiBILyTsUKj1RzzSUYeF5WBmevBwMjVOXqR13dkmEZ8RMA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":660135},"main":"dist/index.js","type":"commonjs","engines":{"node":">=20.10"},"gitHead":"c1cc5e7f4e845aadf9c1ff7ab347ca68e4548cc1","private":false,"scripts":{"test":"npm run test:unit","build":"npm run clean && npm run typecheck && node scripts/build.mjs","clean":"rm -rf dist coverage","test:unit":"vitest run","typecheck":"tsc --noEmit"},"_npmUser":{"name":"codecell-germany","email":"admin@codecell.de"},"_npmVersion":"11.12.1","description":"Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a shared agent skill installer.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"better-sqlite3":"^12.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"marked":"^15.0.12","vitest":"^3.1.2","esbuild":"^0.25.3","commander":"^14.0.0","typescript":"^5.8.3","@types/node":"^22.15.3","gray-matter":"^4.0.3","@types/better-sqlite3":"^7.6.12"},"_npmOperationalInternal":{"tmp":"tmp/company-agent-wiki-skill_0.1.4_1776078053164_0.435769546570842","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@codecell-germany/company-agent-wiki-skill","version":"0.1.5","description":"Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a shared agent skill installer.","private":false,"license":"MIT","type":"commonjs","main":"dist/index.js","bin":{"company-agent-wiki-cli":"dist/index.js","company-agent-wiki-skill":"dist/installer.js"},"publishConfig":{"access":"public"},"engines":{"node":">=20.10"},"scripts":{"clean":"rm -rf dist coverage","typecheck":"tsc --noEmit","build":"npm run clean && npm run typecheck && node scripts/build.mjs","test":"npm run test:unit","test:unit":"vitest run"},"dependencies":{"better-sqlite3":"^12.0.0"},"devDependencies":{"@types/better-sqlite3":"^7.6.12","@types/node":"^22.15.3","commander":"^14.0.0","esbuild":"^0.25.3","gray-matter":"^4.0.3","marked":"^15.0.12","typescript":"^5.8.3","vitest":"^3.1.2"},"gitHead":"f958ea193860057e501f3a95b990cc3c675034e5","_id":"@codecell-germany/company-agent-wiki-skill@0.1.5","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-7OObIZvT5AtFx2/M+riHdc8VK27BKoGLjcC1svIOjncWCNGeHnhWB1lI6UR/GFdZHP7FEAUwCUVp/mQDSJMmTw==","shasum":"68c061fd0485f4a4fdac30efadcbd74846d03329","tarball":"https://registry.npmjs.org/@codecell-germany/company-agent-wiki-skill/-/company-agent-wiki-skill-0.1.5.tgz","fileCount":15,"unpackedSize":682877,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDpy7X2/iOBfgPb1EMktAL/xEbpig1M8GAad0i7AqmTlgIhAKC4y8WRfCD2kCxIaL53PN6apwTlYOZR/+I19H2IGbAC"}]},"_npmUser":{"name":"codecell-germany","email":"admin@codecell.de"},"directories":{},"maintainers":[{"name":"codecell-germany","email":"admin@codecell.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/company-agent-wiki-skill_0.1.5_1776174611086_0.8084870929210748"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T07:08:45.537Z","modified":"2026-04-14T13:50:11.517Z","0.1.0":"2026-04-13T07:08:45.850Z","0.1.1":"2026-04-13T07:27:32.231Z","0.1.2":"2026-04-13T09:37:40.557Z","0.1.3":"2026-04-13T10:29:51.323Z","0.1.4":"2026-04-13T11:00:53.376Z","0.1.5":"2026-04-14T13:50:11.377Z"},"license":"MIT","description":"Context is king: agent-first local company knowledge workspace with metadata-first retrieval, Markdown as truth, SQLite-indexed front matter, Git-aware verification, and a shared agent skill installer.","maintainers":[{"name":"codecell-germany","email":"admin@codecell.de"}],"readme":"# company-agent-wiki-skill\n\n---\n\n# English\n\n## Purpose\n\n> Context is king.\n\n`company-agent-wiki-skill` is an agent-first local company knowledge toolkit.\nIt ships as a real CLI plus a shared agent skill payload, so an agent can set up a private company wiki, verify the index state, search knowledge, inspect metadata and headings first, and only then load full Markdown when needed.\n\nThe shared install layout is meant to work across agent environments that understand the common `~/.agents` skill home, including Codex through a compatibility shim and other skills.sh-style runtimes such as Claude Code or OpenClaw.\n\nThe product surface is the public CLI:\n\n- `company-agent-wiki-cli`\n- `company-agent-wiki-skill`\n\nThe skill explains how an agent should use that CLI safely.\nIt is not a substitute implementation.\n\n## Current scope\n\n- private local knowledge workspaces with Markdown as the source of truth\n- a rebuildable local SQLite index for routing and section search\n- metadata-first retrieval over filename, front matter and headings\n- Git-backed history and diff workflows\n- global per-user workspace discovery for later agents\n- company-profile onboarding blueprints\n- a read-only local web view\n\n## Product model\n\nThe core design is simple:\n\n- Markdown stays human-readable and remains the source of truth\n- SQLite is derived and rebuildable\n- Git stays the audit and history layer\n- the CLI is the real product surface for agents\n\nThe retrieval model is deliberately inspired by Anthropic's Agent Skills model with YAML front matter, progressive disclosure and filesystem-based loading:\n[Anthropic Agent Skills Overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)\n\nThe difference is the retrieval layer.\nHere, front matter is not only stored in Markdown files, but also indexed and filterable through a local SQLite search layer.\n`route` now also understands official alias fields, returns `nearMisses` when no strong match exists and can be inspected through `route-debug` or `coverage`.\n\n## Architecture visuals\n\n### Agentic knowledge ingestion\n\n![Agentic knowledge ingestion](https://cdn.codecell.de/codecell-intern/company-agent-wiki/data-ingestion.jpg)\n\n### Agent-first knowledge retrieval\n\n![Agent-first knowledge retrieval](https://cdn.codecell.de/codecell-intern/company-agent-wiki/data-retrieval.jpg)\n\n## Installation\n\n### 1. Install with one command\n\nThe preferred install path is:\n\n```bash\nnpx -y -p @codecell-germany/company-agent-wiki-skill company-agent-wiki-skill install --force\n```\n\nThat installs:\n\n- the shared skill payload into `~/.agents/skills/company-agent-wiki-cli`\n- the shared runtime into `~/.agents/tools/company-agent-wiki-cli`\n- the shared CLI shim into `~/.agents/bin/company-agent-wiki-cli`\n- the Codex compatibility shim into `~/.codex/bin/company-agent-wiki-cli`\n\nThe skill payload intentionally exists only once under `~/.agents/skills`.\nCodex gets a CLI compatibility shim, but not a second duplicate skill payload.\n\n### 2. Verify the CLI\n\n```bash\ncompany-agent-wiki-cli --help\n\"$HOME/.agents/bin/company-agent-wiki-cli\" --help\n\"$CODEX_HOME/bin/company-agent-wiki-cli\" --help\n\"$HOME/.codex/bin/company-agent-wiki-cli\" --help\n```\n\nFor agent environments that use the shared `~/.agents` home, the direct shim path is often the most reliable fallback.\nIn Codex, the compatibility shim under `~/.codex/bin` also works.\n\n### 3. Optional local repo workflow\n\nIf you are working inside this public implementation repo itself:\n\n```bash\nnpm install\nnpm run build\nnode dist/installer.js install --force\n```\n\n## Requirements\n\n- Node.js `>= 20.10`\n- Git available in `PATH`\n- a private local folder for the actual knowledge workspace\n- optionally a private Git remote URL for that workspace\n\nThe private knowledge workspace must not be this public code repository.\nIt may still be the current dedicated private folder in which you want to build the wiki.\n\nThe SQLite index lives inside the private workspace under `.company-agent-wiki/index.sqlite`.\nIt is intentionally kept out of Git by default because it is rebuildable, binary and noisy in diffs.\n\nThe workspace path can also be stored globally for other agents:\n\n- macOS: `~/Library/Application Support/company-agent-wiki/workspaces.json`\n- Windows: `%APPDATA%\\company-agent-wiki\\workspaces.json`\n- Linux: `${XDG_CONFIG_HOME:-~/.config}/company-agent-wiki/workspaces.json`\n\n## Quick start\n\nCreate or choose a private workspace and run:\n\n```bash\ncompany-agent-wiki-cli setup workspace \\\n  --workspace /absolute/path/to/private-company-knowledge \\\n  --git-init \\\n  --git-remote git@github.com:your-org/private-company-knowledge.git\n```\n\nThen:\n\n```bash\ncompany-agent-wiki-cli doctor --workspace /absolute/path/to/private-company-knowledge --json\ncompany-agent-wiki-cli index rebuild --workspace /absolute/path/to/private-company-knowledge --json\ncompany-agent-wiki-cli verify --workspace /absolute/path/to/private-company-knowledge --json\n```\n\nAfter that, start retrieval:\n\n```bash\ncompany-agent-wiki-cli search \"reverse charge aws invoice\" --workspace /absolute/path/to/private-company-knowledge --type process --department buchhaltung --auto-rebuild --json\ncompany-agent-wiki-cli route \"KI-Telefonassistent\" --workspace /absolute/path/to/private-company-knowledge --type project --project alpha --auto-rebuild --json\ncompany-agent-wiki-cli route-debug \"Google Cloud Statement Beleggrundlage buchen\" --workspace /absolute/path/to/private-company-knowledge --auto-rebuild --json\ncompany-agent-wiki-cli coverage \"Kfz-Steuer Bescheid Erstattung\" --workspace /absolute/path/to/private-company-knowledge --auto-rebuild --json\ncompany-agent-wiki-cli read --doc-id process.example --workspace /absolute/path/to/private-company-knowledge --metadata --headings --auto-rebuild --json\ncompany-agent-wiki-cli read --doc-id process.example --workspace /absolute/path/to/private-company-knowledge --auto-rebuild\ncompany-agent-wiki-cli serve --workspace /absolute/path/to/private-company-knowledge --port 4187 --auto-rebuild\n```\n\nBy default `setup workspace` also creates starter Markdown files such as:\n\n- `wiki-start-here.md`\n- `company-profile.md`\n- `organisation-und-rollen.md`\n- `systeme-und-tools.md`\n- `kernprozesse.md`\n- `projekte-und-roadmap.md`\n- `glossar.md`\n\n## Deterministic first-run order for agents\n\nIf a fresh agent receives this skill, the correct order is:\n\n1. Verify the CLI path:\n   - `company-agent-wiki-cli --help`\n   - `\"$HOME/.agents/bin/company-agent-wiki-cli\" --help`\n   - `\"$CODEX_HOME/bin/company-agent-wiki-cli\" --help`\n   - `\"$HOME/.codex/bin/company-agent-wiki-cli\" --help`\n2. If no workspace exists yet, create one with `setup workspace`.\n3. If a workspace already exists, inspect or register it:\n   - `workspace current --json`\n   - `workspace list --json`\n   - `workspace register --workspace /absolute/path --default --json`\n4. Run `doctor --json`.\n5. Run `index rebuild --json`.\n6. Run `verify --json`.\n7. Only then use `search`, `route`, `read`, `history`, `diff` or `serve`.\n\nIf the current shell is already inside a private workspace, runtime commands may omit `--workspace`.\nIf not, the CLI can fall back to the globally registered default workspace.\n\n## Retrieval workflow\n\nThis is the core agent workflow:\n\n1. Find candidate documents with `search` or `route`.\n2. Narrow candidates with front-matter filters such as `--type`, `--project`, `--department`, `--tag`, `--owner` and `--system`.\n3. If `route` has no strong match, inspect `nearMisses` or run `route-debug` for token-level diagnostics.\n4. Inspect only metadata and headings with `read --metadata --headings --auto-rebuild`.\n5. Load the full Markdown only when the candidate is clearly relevant.\n\nExample:\n\n```bash\ncompany-agent-wiki-cli route \"Projekt Alpha Budget\" --workspace /absolute/path --type project --project alpha --auto-rebuild --json\ncompany-agent-wiki-cli route-debug \"Projekt Alpha Budget\" --workspace /absolute/path --type project --project alpha --auto-rebuild --json\ncompany-agent-wiki-cli read --workspace /absolute/path --doc-id canonical.projekt-alpha-roadmap --metadata --headings --auto-rebuild --json\ncompany-agent-wiki-cli read --workspace /absolute/path --doc-id canonical.projekt-alpha-roadmap --auto-rebuild\n```\n\n## Authoring workflow\n\nFor new company knowledge, use a descriptive filename plus strong front matter.\n\nRecommended filename examples:\n\n- `projekt-alpha-roadmap.md`\n- `buchhaltung-aws-eingangsrechnung.md`\n- `vertrieb-lead-qualifizierung.md`\n\nRecommended front matter:\n\n```yaml\n---\nid: projects.alpha.roadmap\ntitle: Projekt Alpha Roadmap\ntype: project\nstatus: draft\ntags:\n  - projekt\n  - alpha\ndescription: Klare Kurzbeschreibung für Agenten, bevor der Volltext geladen wird.\nsummary: Roadmap und Entscheidungen für Projekt Alpha.\naliases:\n  - alpha roadmap\n  - projekt alpha budget\nproject: alpha\ndepartment: entwicklung\nowners:\n  - nikolas-gottschol\nsystems:\n  - linear\n---\n```\n\nRecommended authoring order:\n\n1. Create the Markdown file inside `knowledge/canonical/` or another registered managed root.\n2. Use a filename that roughly describes the real content.\n3. Set front matter including `id`, `description`, `summary`, `aliases` and the routing fields that matter.\n4. If the content depends on external sources, document provenance, date and source type.\n5. Structure the file with clear `#`, `##` and `###` headings.\n6. Rebuild the index or use an `--auto-rebuild` retrieval path.\n7. Validate discoverability with `search`, `route` and `read --metadata --headings --auto-rebuild`.\n8. If the document is structurally important, update the start page or thematic overview pages as well.\n\n## Company onboarding\n\nYou can also start the optional company-profile onboarding:\n\n```bash\ncompany-agent-wiki-cli onboarding company\ncompany-agent-wiki-cli onboarding company --json\ncompany-agent-wiki-cli onboarding company \\\n  --workspace /absolute/path/to/private-company-knowledge \\\n  --answers-file /absolute/path/to/company-onboarding-answers.json\ncompany-agent-wiki-cli onboarding company \\\n  --workspace /absolute/path/to/private-company-knowledge \\\n  --answers-file /absolute/path/to/company-onboarding-answers.json \\\n  --execute\n```\n\nWithout `--execute`, the CLI stays in preview mode.\nWith `--execute`, it writes draft starter Markdown into the managed root and rebuilds the index.\n\n## Concurrency\n\nThe SQLite index is intentionally local and rebuildable.\nParallel reads such as `search`, `route`, `read`, `history` and `diff` are a supported Phase-1 goal and should work across multiple agents.\n\nWrite paths such as `index rebuild` and onboarding apply are serialized per workspace through a local write lock, so concurrent writes queue behind the active writer instead of colliding.\n\n## Routing ergonomics\n\n- `aliases` is the official front-matter field for alternate document names and audit phrasing.\n- `synonyms` and `search_terms` are also accepted and folded into the same indexed alias set.\n- `route` now returns strong matches plus `nearMisses`, so agents get fallback candidates instead of a dead end.\n- `route-debug` explains which tokens matched in title, description, summary, aliases, tags, headings or path.\n- `coverage` summarizes whether a topic is strongly, partially or not yet documented.\n\n## What Phase 1 does not do\n\n- it does not ingest e-mail, CRM, chat or meeting systems\n- it does not write or edit knowledge through the web UI\n- it does not push or publish Git commits automatically\n- it does not treat the SQLite database as the truth\n- it does not run an interactive prompt loop by itself; the agent still owns the conversation and answer-file creation\n\n## Documentation\n\n- Architecture: [knowledge/ARCHITECTURE.md](knowledge/ARCHITECTURE.md)\n- Release checklist: [knowledge/RELEASE_CHECKLIST.md](knowledge/RELEASE_CHECKLIST.md)\n- Known limitations: [knowledge/KNOWN_LIMITATIONS.md](knowledge/KNOWN_LIMITATIONS.md)\n- Skill entrypoint: [skills/company-agent-wiki-cli/SKILL.md](skills/company-agent-wiki-cli/SKILL.md)\n","readmeFilename":"README.md"}