@codecell-germany/company-agent-wiki-skill 0.1.0

package/skills/company-agent-wiki-cli/references/authoring-workflow.md

@@ -0,0 +1,167 @@
+# Authoring Workflow
+
+## Ziel
+
+Agenten sollen neues Wissen so anlegen, dass der Retrieval-Pfad sauber bleibt:
+
+1. sprechender Dateiname
+2. starkes Front Matter
+3. gute Überschriften
+4. danach Index aktualisieren
+
+## Dateiname
+
+Der Dateiname soll grob widerspiegeln, was im Dokument steht. Bevorzuge:
+
+- `projekt-alpha-roadmap.md`
+- `buchhaltung-aws-eingangsrechnung.md`
+- `vertrieb-lead-qualifizierung.md`
+
+Vermeide:
+
+- `notizen-final-neu.md`
+- `dokument1.md`
+- `misc.md`
+
+## Minimales Front Matter
+
+```yaml
+---
+id: projects.alpha.roadmap
+title: Projekt Alpha Roadmap
+type: project
+status: draft
+tags:
+  - projekt
+  - alpha
+summary: Roadmap und Entscheidungen für Projekt Alpha.
+project: alpha
+department: entwicklung
+owners:
+  - nikolas-gottschol
+systems:
+  - linear
+---
+```
+
+`id` ist für neues Wissen ausdrücklich empfohlen, auch wenn der Parser technisch noch eine ID aus dem Pfad ableiten kann.
+
+## Empfohlene Felder
+
+- `title`: menschenlesbarer Titel
+- `type`: z. B. `project`, `process`, `policy`, `guide`, `note`
+- `status`: z. B. `draft`, `active`, `archived`
+- `tags`: freie Schlagwörter
+- `summary`: kurze 1-Zeilen-Zusammenfassung für Agenten-Routing
+- `project`: Projektkennung oder Projektslug
+- `department`: Abteilung oder Verantwortungsbereich
+- `owners`: verantwortliche Personen oder Teams
+- `systems`: beteiligte Systeme oder Tools
+- `id`: stark empfohlen für stabile Referenzen und sauberes Routing
+
+## Provenienz Bei Externem Wissen
+
+Wenn Wissen aus Webrecherche, Nutzerangaben, E-Mails oder anderen externen Quellen stammt, dokumentiere die Herkunft explizit.
+
+Empfohlen:
+
+- `summary` im Front Matter für die Kurzbeschreibung
+- im Dokument ein Abschnitt `## Quellenstand`
+- Prüfdaten oder Prüfdatum
+- Quelle oder URL
+- Einordnung wie `Primärquelle`, `Sekundärquelle` oder `Nutzerangabe`
+
+Beispiel:
+
+```md
+## Quellenstand
+
+- Geprüft am: 2026-04-12
+- Quelle: https://example.com/partner
+- Einordnung: Sekundärquelle
+- Hinweis: Firmenname und Leistungsbeschreibung wurden zusätzlich durch Nutzerangabe bestätigt.
+```
+
+## Struktur im Dokument
+
+- Verwende eine klare `#`-Hauptüberschrift.
+- Zerlege Inhalte in sinnvolle `##`- und `###`-Abschnitte.
+- Trenne Regeln, Ausnahmen, Beispiele und offene Punkte.
+
+## Empfohlener Anlageprozess Für Neue Dokumente
+
+1. Dokument im passenden Managed Root anlegen, meist unter `knowledge/canonical/`.
+2. Dateinamen so wählen, dass er `title` und Inhalt grob repräsentiert.
+3. Front Matter setzen, idealerweise inklusive `id`.
+4. Bei externem Wissen Provenienz ergänzen.
+5. Abschnitte schreiben.
+6. `company-agent-wiki-cli index rebuild --workspace /absolute/path --json` ausführen.
+7. Optional mit `search --auto-rebuild`, `route --auto-rebuild` und `read --metadata --headings --auto-rebuild` prüfen.
+8. Wenn das Dokument strukturell wichtig ist, Navigation oder README ergänzen.
+
+## Integrations-Checkliste
+
+- Datei angelegt
+- Dateiname sprechend
+- Front Matter vollständig
+- Provenienz dokumentiert, wenn externes Wissen eingeflossen ist
+- Navigation oder Startseite ergänzt, wenn relevant
+- Index aktualisiert
+- `read --metadata --headings --auto-rebuild` geprüft
+
+## Bestehendes Wissen Erweitern
+
+Wenn bereits ein passendes Dokument existiert:
+
+1. erst Kandidaten mit `route` oder `search` finden
+2. mit `read --metadata --headings --auto-rebuild` Struktur prüfen
+3. bestehendes Dokument nur dann erweitern, wenn Thema und Typ sauber passen
+4. sonst neues Dokument anlegen und den Einstiegspunkt verlinken
+
+## Retrieval-Prozess für Agenten
+
+1. Mit `search` oder `route` Kandidaten finden.
+2. Wenn sinnvoll, direkt mit Filtern wie `--type`, `--project`, `--department`, `--tag`, `--owner`, `--system` eingrenzen.
+3. Kandidaten mit `read --metadata --headings --auto-rebuild` prüfen.
+4. Nur bei ausreichend passender Metadatenlage den Volltext mit `read --auto-rebuild` laden.
+
+Beispiel:
+
+```bash
+company-agent-wiki-cli route "Projekt Alpha Budget" --workspace /absolute/path --type project --project alpha --auto-rebuild --json
+company-agent-wiki-cli read --workspace /absolute/path --doc-id canonical.projekt-alpha-roadmap --metadata --headings --auto-rebuild --json
+company-agent-wiki-cli read --workspace /absolute/path --doc-id canonical.projekt-alpha-roadmap --auto-rebuild
+```
+
+## Muster Für Beziehungswissen
+
+Für Partner-, Netzwerk- oder CRM-Wissen ist dieses Muster oft passend:
+
+```yaml
+---
+id: crm.partner.beispiel-partner
+title: Beispiel Partner
+type: relationship
+status: draft
+tags:
+  - crm
+  - partner
+  - netzwerk
+summary: Rolle, Status und Relevanz des Partners im CodeCell-Netzwerk.
+department: vertrieb
+owners:
+  - nikolas-gottschol
+---
+```
+
+Typische Dokumentabschnitte:
+
+- `## Rolle`
+- `## Beziehung und Kontext`
+- `## Aktueller Stand`
+- `## Nächste Schritte`
+- `## Quellenstand`
+
+## Parallelität
+
+Wenn mehrere Agenten dasselbe Workspace verwenden, serialisiere `search`, `route`, `read`, `history` und `diff` möglichst pro Workspace. Der SQLite-Index ist rebuildbar, aber Phase 1 ist nicht für aggressiv parallele Leser ausgelegt.

package/skills/company-agent-wiki-cli/references/command-cheatsheet.md

@@ -0,0 +1,48 @@
+# Command Cheatsheet
+
+## Workspace
+
+```bash
+"$CODEX_HOME/bin/company-agent-wiki-cli" --help
+"$HOME/.codex/bin/company-agent-wiki-cli" --help
+company-agent-wiki-cli about --json
+company-agent-wiki-cli setup workspace --workspace /absolute/path --git-init
+company-agent-wiki-cli onboarding company
+company-agent-wiki-cli onboarding company --workspace /absolute/path --answers-file /absolute/path/to/answers.json
+company-agent-wiki-cli onboarding company --workspace /absolute/path --answers-file /absolute/path/to/answers.json --execute
+company-agent-wiki-cli roots add --workspace /absolute/path --id accounting --path /absolute/path/to/root
+company-agent-wiki-cli roots list --workspace /absolute/path --json
+```
+
+## Health
+
+```bash
+company-agent-wiki-cli doctor --workspace /absolute/path --json
+company-agent-wiki-cli index rebuild --workspace /absolute/path --json
+company-agent-wiki-cli verify --workspace /absolute/path --json
+```
+
+If you are already inside the private workspace, `doctor`, `verify`, `search`, `route`, `read`, `history`, `diff` and `serve` may omit `--workspace`.
+
+## Retrieval
+
+```bash
+company-agent-wiki-cli search "KI-Telefonassistent" --workspace /absolute/path --auto-rebuild --json
+company-agent-wiki-cli search "AWS Rechnung" --workspace /absolute/path --type process --department buchhaltung --auto-rebuild --json
+company-agent-wiki-cli route "vermieter rechnung buchen" --workspace /absolute/path --type process --project finance-ops --auto-rebuild --json
+company-agent-wiki-cli read --doc-id process.example --workspace /absolute/path --metadata --headings --auto-rebuild --json
+company-agent-wiki-cli read --doc-id process.example --workspace /absolute/path --auto-rebuild
+```
+
+## Git Views
+
+```bash
+company-agent-wiki-cli history --workspace /absolute/path --doc-id process.example --json
+company-agent-wiki-cli diff --workspace /absolute/path --doc-id process.example --json
+```
+
+## Web View
+
+```bash
+company-agent-wiki-cli serve --workspace /absolute/path --port 4187 --auto-rebuild
+```

package/skills/company-agent-wiki-cli/references/company-onboarding.md

@@ -0,0 +1,94 @@
+# Company Onboarding Questions
+
+Use this when the workspace exists, but the company profile is still incomplete.
+
+## Goal
+
+The agent should gather the most useful company master data first, without forcing the human to answer everything.
+
+The questionnaire is source-backed. The current model draws especially from:
+
+- IHK guidance on firmierung, Rechtsform, Sitz and Unternehmensgegenstand
+- Existenzgründungsportal material on legal forms
+- BZSt and tax-office information on tax registration, USt-IdNr and W-IdNr
+- Bundesagentur für Arbeit information on Betriebsnummer and Unternehmensnummer
+- Transparenzregister guidance on wirtschaftlich Berechtigte
+
+Rules:
+
+- every question is optional
+- “nein”, “unbekannt” and “später” are valid answers
+- ask only the sections that are relevant
+- do not pressure the user into sharing sensitive data
+
+## Start Command
+
+```bash
+company-agent-wiki-cli onboarding company
+```
+
+For structured agent workflows:
+
+```bash
+company-agent-wiki-cli onboarding company --json
+```
+
+## Preview and Apply
+
+If the agent has already collected answers, store them in a JSON file and preview the generated draft starter Markdown:
+
+```bash
+company-agent-wiki-cli onboarding company \
+  --workspace /absolute/path \
+  --answers-file /absolute/path/to/company-onboarding-answers.json
+```
+
+Write the generated files only with an explicit apply step:
+
+```bash
+company-agent-wiki-cli onboarding company \
+  --workspace /absolute/path \
+  --answers-file /absolute/path/to/company-onboarding-answers.json \
+  --execute
+```
+
+If target files already exist, the CLI refuses the write unless `--force` is added.
+`--execute` requires `--answers-file`, and `--force` is only valid together with `--execute`.
+
+## Answer File Shape
+
+```json
+{
+  "answeredBy": "Codex Agent",
+  "notes": ["Buchhaltung zuerst priorisieren"],
+  "answers": {
+    "official_legal_name": "Beispiel GmbH",
+    "legal_form": "GmbH",
+    "managing_directors": [
+      {
+        "name": "Max Beispiel",
+        "role": "Geschäftsführer",
+        "email": "max@example.com"
+      }
+    ],
+    "vat_regime": "Regelbesteuerung"
+  }
+}
+```
+
+Supported shapes:
+
+- nested metadata plus `answers`
+- flat top-level question IDs plus optional metadata such as `profileId`, `answeredAt`, `answeredBy` and `notes`
+
+## Section Logic
+
+- Ask `Rechtlicher Kern` first.
+- Then ask `Geschäftsführung, Vertretung und Eigentum`.
+- Ask `Steuern und Finanzbasis` if accounting, invoicing or tax workflows matter.
+- Ask `Mitarbeitende und Arbeitgeberstatus` only if employees are relevant.
+- Ask `Organisations- und Wissensbasis` to map the first domains and roots.
+
+## Important Note
+
+The current Phase-1 CLI can materialize only the onboarding-specific draft starter documents. It does not yet run a fully interactive prompt loop and it does not auto-commit the resulting files.

package/skills/company-agent-wiki-cli/references/overview.md

@@ -0,0 +1,41 @@
+# Overview
+
+`company-agent-wiki-cli` is the public interface for a private, local company knowledge workspace.
+
+## Source of Truth
+
+- Markdown files in registered roots
+- tracked workspace metadata in `.company-agent-wiki/workspace.json`
+- descriptive filenames plus Front Matter carry the first routing signal
+
+## Derived State
+
+- `.company-agent-wiki/index.sqlite`
+- `.company-agent-wiki/index-manifest.json`
+
+## Main Commands
+
+- `setup workspace`
+- `onboarding company`
+- `doctor`
+- `verify`
+- `roots add`
+- `roots list`
+- `index rebuild`
+- `search`
+- `route`
+- `read`
+- `history`
+- `diff`
+- `serve`
+
+## Expected Workflow
+
+1. Set up the private workspace.
+2. Use the starter documents or run `onboarding company`, then preview or apply the generated onboarding Markdown from an answers file.
+3. Register any additional Markdown roots.
+4. Rebuild the index.
+5. Verify that the snapshot is fresh. On a brand-new workspace `verify` reports `missing` instead of failing hard.
+6. Search or route to the right document. For active authoring loops, prefer `--auto-rebuild` and front-matter filters such as `--type`, `--project` or `--department`.
+7. Inspect metadata and headings with `read --metadata --headings --auto-rebuild`.
+8. Read the full source document or use the read-only web view.

package/skills/company-agent-wiki-cli/references/workspace-first-run.md

@@ -0,0 +1,39 @@
+# Workspace First Run
+
+## Human Inputs Required
+
+- a private workspace folder path
+- if desired, a private Git remote URL
+
+## What the Agent Can Safely Do
+
+- scaffold the local workspace
+- initialize a local Git repository
+- attach a provided remote URL
+- create the default starter documents for the first useful company knowledge
+- preview or apply onboarding-generated starter Markdown from an answers file
+- register Markdown roots
+- rebuild the derived index
+- verify freshness or a still-missing first index
+- run the read-only web view via `company-agent-wiki-cli serve --workspace /absolute/path --port 4187`
+
+## Runtime Discovery
+
+Before relying on the CLI, verify a real executable path:
+
+```bash
+"$CODEX_HOME/bin/company-agent-wiki-cli" --help
+"$HOME/.codex/bin/company-agent-wiki-cli" --help
+company-agent-wiki-cli --help
+```
+
+The package-based `npx` path is only valid once the npm package is published.
+
+If the current folder is already inside a private workspace, runtime commands may omit `--workspace`.
+
+## What Must Stay Out of This Public Repo
+
+- real business documents
+- exported customer data
+- local workspace indexes
+- private tokens or environment files