diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index 7c70fa0..fa4191a 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -27,12 +27,12 @@ "state": { "type": "markdown", "state": { - "file": "400 Personal Family/460 Family Archive/Harry China Trip.md", + "file": "300 areas/350 AI Pi Coding Agent/Pi Agent Extensions & Skills.md", "mode": "source", "source": false }, "icon": "lucide-file", - "title": "Harry China Trip" + "title": "Pi Agent Extensions & Skills" } } ], @@ -198,7 +198,7 @@ "state": { "type": "file-properties", "state": { - "file": "400 Personal Family/460 Family Archive/Harry China Trip.md" + "file": "300 areas/350 AI Pi Coding Agent/Pi Agent Extensions & Skills.md" }, "icon": "lucide-info", "title": "File properties" @@ -226,6 +226,8 @@ }, "active": "a912940b5902b787", "lastOpenFiles": [ + "300 areas/360 Dev-Ops Network Computers/Home Voice Assistant System.md", + "400 Personal Family/460 Family Archive/Harry China Trip.md", "300 areas/395 AI Tools to try/AI Tool - Eve - Agent Orchestration.md", "300 areas/380 Backup-system/Backup Health Check Commands.md", "100 inbox", @@ -240,19 +242,18 @@ "400 Personal Family/410 Business Ideas/App National Mood.md", "400 Personal Family/420 Social Politics Economics/Chinese Non Silicon Micro Chip.md", "300 areas/395 AI Tools to try/LLM - models to consider.md", - "300 areas/350 AI/AI Design.md", + "300 areas/350 AI Pi Coding Agent/AI Design.md", "300 areas/395 AI Tools to try/AI Tools to try.md", "300 areas/395 AI Tools to try/Automated Agentic Tools.md", "300 areas/395 AI Tools to try/Hermes Ai autonomous Agent.md", "300 areas/395 AI Tools to try/Moonshot AI Launches Kimi Work, a Local Desktop Agent Reportedly Running on Kimi K2.6 With a 300-Sub-Agent Agent Swarm.md", - "300 areas/350 AI/Pi Agent Extensions & Skills.md", - "300 areas/350 AI/Pi Subagent.md", - "300 areas/350 AI/Pi Subagent Integration.md", - "300 areas/350 AI/Security NPM packages tools.md", + "300 areas/350 AI Pi Coding Agent/Pi Agent Extensions & Skills.md", + "300 areas/350 AI Pi Coding Agent/Pi Subagent.md", + "300 areas/350 AI Pi Coding Agent/Pi Subagent Integration.md", + "300 areas/350 AI Pi Coding Agent/Security NPM packages tools.md", "300 areas/395 AI Tools to try/Tools to try with AI.md", "300 areas/350 AI/Tools to try", - "300 areas/350 AI/Ai memory management.md", - "300 areas/350 AI/Ai planning flow control tools.md", + "300 areas/350 AI Pi Coding Agent/Ai memory management.md", "400 Personal Family/490 Garden Food Houses Farms Hobbies", "400 Personal Family/480 Art Music Photography", "Pasted image 20260915083537.png", diff --git a/300 areas/350 AI/AI Design.md b/300 areas/350 AI Pi Coding Agent/AI Design.md similarity index 100% rename from 300 areas/350 AI/AI Design.md rename to 300 areas/350 AI Pi Coding Agent/AI Design.md diff --git a/300 areas/350 AI/Ai memory management.md b/300 areas/350 AI Pi Coding Agent/Ai memory management.md similarity index 100% rename from 300 areas/350 AI/Ai memory management.md rename to 300 areas/350 AI Pi Coding Agent/Ai memory management.md diff --git a/300 areas/350 AI/Ai planning flow control tools.md b/300 areas/350 AI Pi Coding Agent/Ai planning flow control tools.md similarity index 100% rename from 300 areas/350 AI/Ai planning flow control tools.md rename to 300 areas/350 AI Pi Coding Agent/Ai planning flow control tools.md diff --git a/300 areas/350 AI/Pi Agent Extensions & Skills.md b/300 areas/350 AI Pi Coding Agent/Pi Agent Extensions & Skills.md similarity index 96% rename from 300 areas/350 AI/Pi Agent Extensions & Skills.md rename to 300 areas/350 AI Pi Coding Agent/Pi Agent Extensions & Skills.md index 86a2602..83ac604 100644 --- a/300 areas/350 AI/Pi Agent Extensions & Skills.md +++ b/300 areas/350 AI Pi Coding Agent/Pi Agent Extensions & Skills.md @@ -186,6 +186,7 @@ v0.7.0, installed globally. 7 task tools: `TaskCreate`, `TaskList`, `TaskGet`, ` | **ste-writing** | Rewrite prose (docs, READMEs, PRs, errors) into ASD-STE100 Simplified Technical English. Removes AI slop. Two modes: strict (procedures) and STE-flavored (general prose). Includes heuristic anti-slop linter (ste-lint.py). | | **project-diagramming-mermaid** | Outline codebase/project as Mermaid → `/docs/.mmd` + render to `/docs/diagrams/` via mmdc (nixpkgs mermaid-cli) → prompt for Archify follow-up. Per project: `/config-add skill project-diagramming-mermaid`. See [[Dev-Ops Tooling — Mermaid, Archify, Vikunja & Outline]] | | **project-diagramming-archify** | Mermaid or plain language → Archify JSON IR → validate (showcase) → deliver interactive HTML to `/docs/-map.html`. Vendor renderer: `~/.agents/skills/archify` (v2.14). Per project: `/config-add skill project-diagramming-archify`. See [[Dev-Ops Tooling — Mermaid, Archify, Vikunja & Outline]] | +| **project-docs** | Meta-skill to initiate or update multi-platform project documentation across Gitea (tech README), Obsidian (human/portfolio showcase), Mermaid/Archify (diagrams & map links), Vikunja (human tasks), and Outline (AI context index using `ste-writing`). Per project: `/config-add skill project-docs` | | **project-ops** | Task/stage/progress via **Vikunja** API + documentation via **Outline** API (bearer tokens in `10-secrets.conf`). Create/update tasks, move buckets, percent-done, read/write docs. Per project: `/config-add skill project-ops`. See [[Dev-Ops Tooling — Mermaid, Archify, Vikunja & Outline]] | | **design-build** | Generate production-ready HTML/Tailwind code from design specifications and DESIGN.md design tokens. | | **design-explore** | Generate UI design mockups as images for exploration and ideation. Supports DESIGN.md for design-token-accurate mockups. | @@ -245,6 +246,36 @@ The `markitdown-vision` wrapper auto-sources `OPENROUTER_API_KEY` from `~/.confi --- +## project-docs + +Meta-skill for initiating and updating multi-platform project documentation across human and AI systems. Orchestrates other skills (`nixos-workflow`, `project-diagramming-mermaid`, `project-diagramming-archify`, `obsidian-cli`, `ste-writing`). + +### Multi-Platform Roles + +| Platform | Target | Purpose & Tone | Key Output | +| :--- | :--- | :--- | :--- | +| **Gitea** | Developers / Resume | Technical repo README. Standard concise markdown. Highlights tech stack, usage, and portfolio skills. | `README.md` (embedded Mermaid diagram, Archify map links) | +| **Obsidian** | Humans / Hiring Managers | **Human understanding**. Simple, layperson-friendly language. Highlights skills, tools, and employment concepts. | Vault note (`.md`) | +| **Mermaid + Archify** | Visualization | High-level system architecture and flow diagrams. | `docs/.mmd`, SVG/PNG renderings, hyperlinked nodes to `maps.lab.audasmedia.com.au` | +| **Vikunja** | Humans | High-level task tracking for human team members. | Vikunja Project & Task Board | +| **Outline** | AI Agents | **Deep AI context & document index**. Itemizes what is in each document in the collection so AI agents can inject specific files directly without searching. **Must use `ste-writing` skill** for terse, plain, slop-free text. | Outline Overview & Collection docs | + +### Workflow & Usage + +```bash +# Enable per-project +/config-add skill project-docs +/reload + +# Invoke initiate mode +"Initiate project documentation using project-docs" + +# Invoke update mode +"Update project docs across Gitea, Obsidian, Vikunja, and Outline" +``` + +--- + ## falcode-zellij Zellij plugin + agent extensions that track all active AI coding panes (pi, OpenCode, Claude Code) across Zellij sessions in a floating popup. Jump to any pane with one keystroke. Shows attention icons on Zellij tabs when an agent starts/stops working. diff --git a/300 areas/350 AI/Pi Subagent Integration.md b/300 areas/350 AI Pi Coding Agent/Pi Subagent Integration.md similarity index 100% rename from 300 areas/350 AI/Pi Subagent Integration.md rename to 300 areas/350 AI Pi Coding Agent/Pi Subagent Integration.md diff --git a/300 areas/350 AI/Pi Subagent.md b/300 areas/350 AI Pi Coding Agent/Pi Subagent.md similarity index 100% rename from 300 areas/350 AI/Pi Subagent.md rename to 300 areas/350 AI Pi Coding Agent/Pi Subagent.md diff --git a/300 areas/350 AI/Security NPM packages tools.md b/300 areas/350 AI Pi Coding Agent/Security NPM packages tools.md similarity index 100% rename from 300 areas/350 AI/Security NPM packages tools.md rename to 300 areas/350 AI Pi Coding Agent/Security NPM packages tools.md