diff options
Diffstat (limited to 'skills')
| -rw-r--r-- | skills/a2a-contract-framework.md | 30 | ||||
| -rw-r--r-- | skills/bug-tracker.md | 1 | ||||
| -rw-r--r-- | skills/index.json | 2 | ||||
| -rw-r--r-- | skills/localize-external-assets.md | 18 | ||||
| -rw-r--r-- | skills/macro-engine-debug.md | 20 | ||||
| -rw-r--r-- | skills/macro-engine-onboarding.md | 20 | ||||
| -rw-r--r-- | skills/macro-engine.md | 28 | ||||
| -rw-r--r-- | skills/memory-and-profile.md | 30 | ||||
| -rw-r--r-- | skills/memory-map.md | 51 | ||||
| -rw-r--r-- | skills/memory.md | 66 | ||||
| -rw-r--r-- | skills/mindmap-master-guide.md | 40 | ||||
| -rw-r--r-- | skills/mindmap-user-guide.md | 40 | ||||
| -rw-r--r-- | skills/mindmap-workflow.md | 39 | ||||
| -rw-r--r-- | skills/mindmap.md | 50 | ||||
| -rw-r--r-- | skills/neural-vfs-indexer.md | 21 | ||||
| -rw-r--r-- | skills/project-profile-manager.md | 1 | ||||
| -rw-r--r-- | skills/task-manager.md | 1 | ||||
| -rw-r--r-- | skills/webdav-operations.md | 33 | ||||
| -rw-r--r-- | skills/webdav-sync.md | 40 | ||||
| -rw-r--r-- | skills/webdav.md | 44 | ||||
| -rw-r--r-- | skills/webx11-dev-cycle.md | 1 |
21 files changed, 262 insertions, 314 deletions
diff --git a/skills/a2a-contract-framework.md b/skills/a2a-contract-framework.md new file mode 100644 index 0000000..51678b2 --- /dev/null +++ b/skills/a2a-contract-framework.md @@ -0,0 +1,30 @@ +--- +name: a2a-contract-framework +description: Framework for formalizing Agent-to-Agent (A2A) contracts to ensure deterministic collaboration. +tags: a2a, agent-orchestration, protocol, newos4 +category: system +--- + +# A2A Contract Framework + +## 1. Purpose +To move from "best-effort" delegation to "contractual" execution by defining a strict interface (`.contract.json`) for every agent role. + +## 2. Contract Schema +Every agent must have an associated contract containing: +- `role`: The official designation (e.g., "researcher"). +- `capabilities`: `string[]` of authorized toolsets. +- `input_schema`: JSON Schema defining required parameters. +- `output_schema`: JSON Schema defining guaranteed return format. +- `sla`: Response time goals and accuracy thresholds. +- `resource_weight`: Numeric value representing cognitive cost. + +## 3. Workflow +1. **Handshake**: Orchestrator requests contract from Agent. +2. **Verification**: Orchestrator validates task against `input_schema`. +3. **Execution**: Agent executes using only `capabilities`. +4. **Validation**: Orchestrator validates result against `output_schema`. + +## 4. Implementation Path +- Store contracts in `.contracts/` directory. +- Reference contracts during `spawn_agent` calls. diff --git a/skills/bug-tracker.md b/skills/bug-tracker.md index 05963e4..bb8febf 100644 --- a/skills/bug-tracker.md +++ b/skills/bug-tracker.md @@ -2,6 +2,7 @@ name: bug-tracker description: A systematic approach to tracking and managing bugs in the VFS. tags: [dev, debugging, management, workflow] +category: dev --- # Bug Tracking Workflow diff --git a/skills/index.json b/skills/index.json index 4b168ca..200bc02 100644 --- a/skills/index.json +++ b/skills/index.json @@ -1 +1 @@ -{"navigating-the-terminal":{"name":"navigating-the-terminal","description":"How to explore the WebX11 terminal, find commands, check status, and navigate the filesystem","tags":["terminal","navigation","help","filesystem"],"category":"system","created":"2026-06-02T22:07:32.333Z","updated":"2026-06-02T22:07:32.333Z"},"memory-and-profile":{"name":"memory-and-profile","description":"How to use the user profile system, session memory, and pattern tracking for persistent context","tags":["memory","profile","session","persistence"],"category":"system","created":"2026-06-02T22:07:32.333Z","updated":"2026-06-02T22:07:32.333Z"},"web-search-and-fetch":{"name":"web-search-and-fetch","description":"How to search the web and fetch URL content using the WebX11 proxy API","tags":["search","fetch","web","proxy","api"],"category":"research","created":"2026-06-02T22:07:32.334Z","updated":"2026-06-02T22:07:32.334Z"},"module-management":{"name":"module-management","description":"How to view, edit, test, reload modules and manage startup configuration","tags":["modules","editing","code","self-improvement"],"category":"dev","created":"2026-06-02T22:07:32.334Z","updated":"2026-06-02T22:07:32.334Z"},"system-maintenance":{"name":"system-maintenance","description":"How to reset, troubleshoot, and maintain the WebX11 terminal","tags":["system","maintenance","reset","troubleshoot","config"],"category":"system","created":"2026-06-02T22:07:32.334Z","updated":"2026-06-02T22:07:32.334Z"},"backup-and-restore":{"name":"backup-and-restore","description":"How to backup, restore, and export WebX11 data","tags":["backup","restore","export","import","persistence"],"category":"system","created":"2026-06-02T22:07:32.334Z","updated":"2026-06-02T22:07:32.334Z"},"mindmap-workflow":{"name":"mindmap-workflow","description":"How to create, view, edit, and manage brainstorming mindmaps","tags":["mindmap","brainstorming","planning","organization"],"category":"productivity","created":"2026-06-02T22:07:32.334Z","updated":"2026-06-02T22:07:32.334Z"},"skills-system-guide":{"name":"skills-system-guide","description":"How to use the skills system: load, create, patch, list, and audit skills for persistent procedural memory","tags":["skills","system","meta"],"category":"system","created":"2026-06-02T22:07:32.334Z","updated":"2026-06-02T22:07:32.334Z"},"agent-orchestration":{"name":"agent-orchestration","description":"How to use the agent registry, leases, and orchestrator for multi-agent workflows","tags":["agents","orchestration","delegation","leases"],"category":"system","created":"2026-06-02T22:07:32.335Z","updated":"2026-06-02T22:07:32.335Z"},"debug-panel-and-logs":{"name":"debug-panel-and-logs","description":"How to use the debug panel, session logging, and terminal diagnostics","tags":["debug","logging","diagnostics","troubleshooting"],"category":"system","created":"2026-06-02T22:07:32.335Z","updated":"2026-06-02T22:07:32.335Z"},"webdav-operations":{"name":"webdav-operations","description":"How to use WebDAV cloud storage for backup, file sync, and remote file access","tags":["webdav","cloud","backup","sync","storage"],"category":"system","created":"2026-06-02T22:07:32.335Z","updated":"2026-06-02T22:07:32.335Z"},"security-and-safety":{"name":"security-and-safety","description":"How to use WebX11 security levels, command blocking, and safety features","tags":["security","safety","blocking","permissions"],"category":"system","created":"2026-06-02T22:07:32.335Z","updated":"2026-06-02T22:07:32.335Z"},"mindmap-user-guide":{"name":"mindmap-user-guide","description":"How to create, view, and manage brainstorming mindmaps using the mindmap terminal module","tags":["mindmap","brainstorming","organization","planning"],"category":"productivity","created":"2026-06-02T13:20:28.672Z","updated":"2026-06-02T13:20:28.672Z"},"bug-tracker":{"name":"bug-tracker","description":"Systematic workflow for tracking bugs using a JSON log file in the VFS.","tags":["dev","debugging","management","workflow"],"category":"dev","created":"2026-06-02T10:10:44.447Z","updated":"2026-06-02T10:10:44.447Z"},"task-manager":{"name":"task-manager","description":"A systematic workflow for tracking and managing tasks via a VFS JSON store.","tags":["productivity","tasks","vfs"],"category":"productivity","created":"2026-06-02T10:12:44.476Z","updated":"2026-06-02T10:12:44.476Z"},"agent-optimization-framework":{"name":"agent-optimization-framework","description":"","tags":["optimization","agentic-workflow","efficiency","tool-calls"],"category":"system","created":"2026-05-29T14:52:23.451Z","updated":"2026-05-29T14:52:23.451Z"},"macro-engine-debug":{"name":"macro-engine-debug","description":"","tags":["debug","a-repair","macro"],"category":"system","created":"2026-05-29T15:06:24.057Z","updated":"2026-05-29T15:06:24.057Z"},"macro-engine-onboarding":{"name":"macro-engine-onboarding","description":"","tags":["onboarding","context","macro"],"category":"system","created":"2026-05-29T15:06:24.064Z","updated":"2026-05-29T15:06:24.064Z"},"project-profile-manager":{"name":"project-profile-manager","description":"","tags":["context","memory","workspace"],"category":"system","created":"2026-05-29T15:08:44.897Z","updated":"2026-05-29T15:08:44.897Z"}}
\ No newline at end of file +{"a2a-contract-framework":{"name":"a2a-contract-framework","description":"Framework for formalizing Agent-to-Agent (A2A) contracts to ensure deterministic collaboration.","tags":["a2a","agent-orchestration","protocol","newos4"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"agent-optimization-framework":{"name":"agent-optimization-framework","description":"System for reducing tool-call latency and increasing agentic precision through programmatic workflows.","tags":["optimization","agentic-workflow","efficiency","tool-calls"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"agent-orchestration":{"name":"agent-orchestration","description":"How to use the agent registry, leases, and orchestrator for multi-agent workflows","tags":["agents","orchestration","delegation","leases"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"backup-and-restore":{"name":"backup-and-restore","description":"How to backup, restore, and export WebX11 data","tags":["backup","restore","export","import","persistence"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"bug-tracker":{"name":"bug-tracker","description":"A systematic approach to tracking and managing bugs in the VFS.","tags":["dev","debugging","management","workflow"],"category":"dev","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"debug-panel-and-logs":{"name":"debug-panel-and-logs","description":"How to use the debug panel, session logging, and terminal diagnostics","tags":["debug","logging","diagnostics","troubleshooting"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"localize-external-assets":{"name":"localize-external-assets","description":"Downloads external JS/CSS assets to the VFS to bypass server-side security restrictions on external scripts.","tags":["security","assets","vfs","localization"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"macro-engine":{"name":"macro-engine","description":"Rapid session onboarding and module debugging — context recovery, status checks, source analysis, and live testing.","tags":["macro","onboarding","debug","context","recovery","development"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"memory":{"name":"memory","description":"Manage user profiles, session memory, and persistent memory map for cross-session context.","tags":["memory","profile","session","persistence","context","map"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"mindmap":{"name":"mindmap","description":"Create, manage, export, and persist brainstorming mindmaps using the mindmap terminal module.","tags":["mindmap","brainstorming","planning","organization","visualization"],"category":"productivity","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"module-management":{"name":"module-management","description":"How to view, edit, test, reload modules and manage startup configuration","tags":["modules","editing","code","self-improvement"],"category":"dev","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"navigating-the-terminal":{"name":"navigating-the-terminal","description":"How to explore the WebX11 terminal, find commands, check status, and navigate the filesystem","tags":["terminal","navigation","help","filesystem"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"neural-vfs-indexer":{"name":"neural-vfs-indexer","description":"Scans the VFS to create semantic mappings between concepts and file paths.","tags":["neural-vfs","semantic","indexing","newos4"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"project-profile-manager":{"name":"project-profile-manager","description":"Handles saving and loading of project-specific context bundles.","tags":["context","memory","workspace"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"security-and-safety":{"name":"security-and-safety","description":"How to use WebX11 security levels, command blocking, and safety features","tags":["security","safety","blocking","permissions"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"skills-system-guide":{"name":"skills-system-guide","description":"How to use the skills system: load, create, patch, list, and audit skills for persistent procedural memory","tags":["skills","system","meta"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"system-maintenance":{"name":"system-maintenance","description":"How to reset, troubleshoot, and maintain the WebX11 terminal","tags":["system","maintenance","reset","troubleshoot","config"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"task-manager":{"name":"task-manager","description":"A systematic approach to managing tasks using a JSON-based tracking system in the VFS.","tags":["productivity","management","organization"],"category":"productivity","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"web-search-and-fetch":{"name":"web-search-and-fetch","description":"How to search the web and fetch URL content using the WebX11 proxy API","tags":["search","fetch","web","proxy","api"],"category":"research","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"webdav":{"name":"webdav","description":"Configure, sync, backup, and restore VFS via WebDAV cloud storage.","tags":["webdav","cloud","backup","sync","storage","vfs"],"category":"system","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"},"webx11-dev-cycle":{"name":"webx11-dev-cycle","description":"Professional workflow for analyzing, prototyping, and implementing new features in WebX11.","tags":["development","workflow","webx11"],"category":"dev","created":"2026-06-03T22:22:07.000Z","updated":"2026-06-03T22:22:07.000Z"}} diff --git a/skills/localize-external-assets.md b/skills/localize-external-assets.md new file mode 100644 index 0000000..b7a1c9b --- /dev/null +++ b/skills/localize-external-assets.md @@ -0,0 +1,18 @@ +--- +name: localize-external-assets +description: Downloads external JS/CSS assets to the VFS to bypass server-side security restrictions on external scripts. +tags: [security, assets, vfs, localization] +category: system +--- + +### Logic +1. Identify external URLs in the target HTML/CSS. +2. Use the `download <url>` command to save these files into a local `/assets/` directory. +3. Update the HTML file to reference local paths (e.g., `src="https://cdn..."` $\rightarrow$ `src="/assets/..."`). + +### Implementation Steps +1. **Scan**: Read the file and extract all `src` and `href` attributes pointing to external domains. +2. **Prepare**: Create an `/assets/` directory if it doesn't exist. +3. **Fetch**: Execute `download <url>` for every identified external dependency. +4. **Patch**: Use `write_file` to replace the remote URLs with the local VFS paths. +5. **Verify**: Confirm the file is successfully updated and assets are present in the VFS. diff --git a/skills/macro-engine-debug.md b/skills/macro-engine-debug.md deleted file mode 100644 index e8cc662..0000000 --- a/skills/macro-engine-debug.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: macro-engine-debug -description: A compound operation sequence to audit, view, and test a module for stability and correctness. -tags: [debug, a-repair, macro, development] -category: dev ---- - -# Macro Engine Debug - -## 🎯 Objective -Rapidly diagnose issues within a loaded module by combining status checks, source analysis, and live testing. - -## 🛠️ Execution Steps -1. **Status Check:** Call `get_module_status` to identify if the module is currently loaded, modified, or has a remote URL mismatch. -2. **Source Analysis:** Call `view_module(name)` to examine the current implementation logic. -3. **Live Testing:** Use `test_module(name)` to load the edited version from `/_mods/` and verify the fix. -4. **Synthesis:** Compare the test results with the original bug report to confirm the resolution. - -## 🔄 Workflow -`get_module_status` ➔ `view_module` ➔ `test_module` ➔ `report` diff --git a/skills/macro-engine-onboarding.md b/skills/macro-engine-onboarding.md deleted file mode 100644 index 669d665..0000000 --- a/skills/macro-engine-onboarding.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: macro-engine-onboarding -description: A rapid context-recovery sequence to align the AI with the current session state and active projects. -tags: [onboarding, context, recovery, macro] -category: system ---- - -# Macro Engine Onboarding - -## 🎯 Objective -Efficiently recover state and context at the start of a session to avoid redundant queries and minimize hallucinations. - -## 🛠️ Execution Steps -1. **Session Review:** Call `session_recent(3)` to identify the last active tasks and their outcomes. -2. **VFS Snapshot:** Call `list_files('')` to examine the root directory for new project files or configuration changes. -3. **Procedure Retrieval:** Call `load_skills('current-task')` to see if any stored procedures are applicable to the immediate goal. -4. **User Preferences:** Call `user_list` to check for project-specific flags or persistent preferences (e.g., preferred models, project paths). - -## 🔄 Workflow -`session_recent` ➔ `list_files` ➔ `load_skills` ➔ `user_list` diff --git a/skills/macro-engine.md b/skills/macro-engine.md new file mode 100644 index 0000000..ca5ef5e --- /dev/null +++ b/skills/macro-engine.md @@ -0,0 +1,28 @@ +--- +name: macro-engine +description: Rapid session onboarding and module debugging — context recovery, status checks, source analysis, and live testing. +tags: [macro, onboarding, debug, context, recovery, development] +category: system +--- + +TODO: Category should be system+dev — primary use is debugging modules (dev) for context recovery (system). Using 'system' as primary. + +## Session Onboarding (context recovery) + +Efficiently recover state at session start to avoid redundant queries. + +1. **Session Review** — `session_recent(3)` to identify last active tasks and outcomes +2. **VFS Snapshot** — `list_files('')` to examine root directory for new files/config changes +3. **Procedure Retrieval** — `load_skills('current-task')` for applicable stored procedures +4. **User Preferences** — `user_list` for project-specific flags/persistent preferences + +**Workflow:** `session_recent` → `list_files` → `load_skills` → `user_list` + +## Module Debugging (rapid diagnosis) + +1. **Status Check** — `get_module_status` to see if module is loaded, modified, or has a remote URL mismatch +2. **Source Analysis** — `view_module(name)` to examine current implementation logic +3. **Live Testing** — `test_module(name)` to load edited version from `/_mods/` and verify the fix +4. **Synthesis** — compare test results with the original bug report to confirm resolution + +**Workflow:** `get_module_status` → `view_module` → `test_module` → `report`
\ No newline at end of file diff --git a/skills/memory-and-profile.md b/skills/memory-and-profile.md deleted file mode 100644 index 6605893..0000000 --- a/skills/memory-and-profile.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -name: memory-and-profile -description: How to use the user profile system, session memory, and pattern tracking for persistent context -tags: [memory, profile, session, persistence] -category: system ---- -## Steps -1. **User Profile (persists across sessions):** - - user_get(key) — read any profile field (e.g. "preferredModel", "fontSize") - - user_set(key, value) — write to profile, auto-persists to localStorage - - user_list — show all stored profile keys - - user_forget(key) — delete a profile key - - Dot notation supported: user_set knownFacts.name "Alex" - -2. **Session Memory (VFS-based daily logs):** - - session_save(summary) — save a summary of what was accomplished - - session_load(date) — read a specific day's log (format: YYYY-MM-DD) - - session_recent(count) — show last N session summaries - - session_stats — aggregate totals across all sessions - - Recent sessions auto-load into context on first message - -3. **Conversation Patterns:** - - Pattern tracking runs automatically — frequent topics surface as hints - - my-set, my-get, my-list store additional personal data - - AI conversation context persists within a session (use ai-clear to reset) - -4. **When to use:** - - At start: call session_recent(3) to see what was worked on before - - After identifying user preferences: call user_set to store them - - After complex tasks: call session_save with a brief summary
\ No newline at end of file diff --git a/skills/memory-map.md b/skills/memory-map.md deleted file mode 100644 index b8c0f83..0000000 --- a/skills/memory-map.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -name: memory-map -description: Maintain and query the persistent memory map at /memory/map.json for Agando/DarkMoto Systems. -category: system -tags: memory, persistence, context, map, agando ---- - -## Purpose -Keep a living index of projects, infrastructure, preferences, active issues, and session history so the AI never asks Agando to repeat himself. - -## File Location -- `/memory/map.json` — primary memory map -- `/memory/index.json` — session index (auto-generated) - -## Workflow - -### 1. Read Before Acting -At the start of any session or when context is unclear: -```bash -read_file("memory/map.json") -``` - -### 2. Update After Significant Work -After any task that changes status, fixes an issue, or adds knowledge: -```bash -# Read current map -read_file("memory/map.json") - -# Modify relevant section(s) -# Write back -write_file("memory/map.json", <updated_json>) -``` - -### 3. Add Session Link -Append to `recent_sessions` (keep last 10): -```json -{"date": "YYYY-MM-DD", "file": "memory/YYYY-MM-DD.json", "summary": "..."} -``` - -## Map Structure -- `projects` — WebX11, clients, personal builds, stores -- `infrastructure` — security stack, backup systems, constraints -- `preferences` — communication style, UI needs (#00ff88, 48px touch targets) -- `active_issues` — open tasks, blockers, manual steps required -- `recent_sessions` — quick links to session logs - -## Rules -- NEVER ask Agando for info already in the map. -- If info is stale or wrong, update it immediately. -- Use `session_save()` after complex tasks to populate index.json. -- Keep `active_issues` accurate — remove resolved items.
\ No newline at end of file diff --git a/skills/memory.md b/skills/memory.md new file mode 100644 index 0000000..d3b46fe --- /dev/null +++ b/skills/memory.md @@ -0,0 +1,66 @@ +--- +name: memory +description: Manage user profiles, session memory, and persistent memory map for cross-session context. +tags: [memory, profile, session, persistence, context, map] +category: system +--- + +## User Profile (localStorage — user_get/user_set) + +| Command | Purpose | +|---------|---------| +| `user_get(key)` | Read profile field (e.g. "preferredModel") | +| `user_set(key, value)` | Write to profile, auto-persists | +| `user_list` | Show all stored profile keys | +| `user_forget(key)` | Delete a profile key | + +Dot notation supported: `user_set knownFacts.name "Alex"` + +## Session Memory (VFS-based daily logs) + +| Command | Purpose | +|---------|---------| +| `session_save(summary)` | Save session summary | +| `session_load(date)` | Read day's log (YYYY-MM-DD) | +| `session_recent(count)` | Last N session summaries | +| `session_stats` | Aggregate totals | + +Recent sessions auto-load into context on first message. + +## Persistent Memory Map (/memory/map.json) + +An index of projects, preferences, issues, and session history so the AI never asks to repeat itself. + +**Location:** `/memory/map.json` — primary map; `/memory/index.json` — auto-generated session index + +**Read Before Acting:** +``` +read_file("memory/map.json") +``` + +**Update After Significant Work:** +- Read current map, modify relevant section, write back +- Append to `recent_sessions` (keep last 10) + +**Map Structure:** +- `projects` — WebX11, clients, personal builds +- `infrastructure` — security stack, backups, constraints +- `preferences` — communication style, UI needs +- `active_issues` — open tasks, blockers, manual steps +- `recent_sessions` — quick links to session logs + +**Rules:** +- NEVER ask for info already in the map +- If info is stale, update immediately +- Use `session_save()` after complex tasks +- Keep `active_issues` accurate — remove resolved items + +## Conversation Patterns +- Pattern tracking runs automatically — frequent topics surface as hints +- `my-set`, `my-get`, `my-list` store additional personal data +- AI conversation context persists within a session (use `ai-clear` to reset) + +## When to Use +- Session start: call `session_recent(3)`, then `read_file("memory/map.json")` +- After identifying user preferences: `user_set` to store them +- After complex tasks: `session_save` with a brief summary, update map
\ No newline at end of file diff --git a/skills/mindmap-master-guide.md b/skills/mindmap-master-guide.md deleted file mode 100644 index 83cebd2..0000000 --- a/skills/mindmap-master-guide.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -name: mindmap-master-guide -description: Comprehensive guide to creating, managing, and exporting brainstorming mindmaps using the mindmap terminal module. -tags: [mindmap, brainstorming, planning, organization, visualization] -category: productivity ---- -## Core Workflow - -1. **Initialization** - - `mindmap new "<topic>" -t tag1,tag2` — Creates a root node. - - Tags are optional (e.g., planning, research, dev). - - The root node is auto-assigned a color from the 7-color palette. - -2. **Expansion (Adding Nodes)** - - `mindmap add <parent-id> "<idea>" -t tag` — Adds a child node to a specific parent. - - To find the `parent-id`, use `mindmap show`. IDs are 4-character random strings (e.g., `a3f8`). - -3. **Visualization** - - `mindmap show` — Displays the full tree using Unicode box-drawing. - - `mindmap show <id>` — Displays a subtree starting from the specified node. - -4. **Refinement (Editing)** - - `mindmap rename <id> "<new text>"` — Changes the node text. - - `mindmap color <id> <color>` — Sets node color (`red`, `green`, `yellow`, `blue`, `cyan`, `magenta`, `white`). - - `mindmap tag <id> <tag>` — Assigns or updates a tag for the node. - -5. **Persistence & Storage** - - `mindmap save <name>` — Saves the current map to localStorage. - - `mindmap load <name>` — Restores a saved map. - - `mindmap list` — Lists all saved mindmaps. - - `mindmap delete <name>` — Removes a saved map from storage. - -6. **Exporting** - - `mindmap export [id]` — Generates a Markdown bullet list of the map (or specific subtree), automatically copying the result to the clipboard. - -## Use Cases -- **Brainstorming:** Map out feature sets, project architectures, or conceptual ideas. -- **Planning:** Decompose complex tasks into manageable sub-tasks. -- **Organization:** Structure research findings or user requirements. -- **Trigger Phrases:** Use when the user mentions "brainstorm", "diagram", "organize thoughts", "plan", or "map out". diff --git a/skills/mindmap-user-guide.md b/skills/mindmap-user-guide.md deleted file mode 100644 index 7bee410..0000000 --- a/skills/mindmap-user-guide.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -name: mindmap-user-guide -description: How to create, view, and manage brainstorming mindmaps using the mindmap terminal module -tags: [mindmap, brainstorming, organization, planning] -category: productivity ---- -## Steps - -1. **Create a new mindmap:** - - `mindmap new "<topic>" -t tag1,tag2` — creates a root node - - Tags are optional (e.g. planning, research, dev) - - Root gets auto-assigned a color - -2. **Add child nodes:** - - `mindmap add <parent-id> "<idea>" -t tag` — add a child - - Get the parent-id from `mindmap show` - - IDs are 4-char random strings (e.g. a3f8, x7k2) - -3. **View the mindmap:** - - `mindmap show` — full tree with Unicode box-drawing - - `mindmap show <id>` — subtree starting at that node - -4. **Edit nodes:** - - `mindmap rename <id> "<new text>"` — change text - - `mindmap color <id> <color>` — set color (red/green/yellow/blue/cyan/magenta/white) - - `mindmap tag <id> <tag>` — add a tag - -5. **Persistence:** - - `mindmap save <name>` — save to localStorage - - `mindmap load <name>` — restore - - `mindmap list` — show saved mindmaps - - `mindmap delete <name>` — remove saved - -6. **Export:** - - `mindmap export [id]` — Markdown bullet list output - -## When to use -- User wants to brainstorm, organize ideas, plan features -- User says "map out", "diagram", "brainstorm", "organize thoughts" -- Visualizing project structure or task decomposition
\ No newline at end of file diff --git a/skills/mindmap-workflow.md b/skills/mindmap-workflow.md deleted file mode 100644 index f05c237..0000000 --- a/skills/mindmap-workflow.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -name: mindmap-workflow -description: How to create, view, edit, and manage brainstorming mindmaps -tags: [mindmap, brainstorming, planning, organization] -category: productivity ---- -## Steps -1. **Create a new mindmap:** - - mindmap new "<topic>" -t tag1,tag2 — creates a root node - - Tags are optional (e.g. planning, research, dev) - - Root gets auto-assigned a color from 7-color palette - -2. **Add child nodes:** - - mindmap add <parent-id> "<idea>" -t tag — add a child - - Get the parent-id from mindmap show - - IDs are 4-char random strings (e.g. a3f8, x7k2) - -3. **View:** - - mindmap show — full tree with Unicode box-drawing - - mindmap show <id> — subtree starting at that node - -4. **Edit nodes:** - - mindmap rename <id> "<new text>" — change text - - mindmap color <id> <color> — set color (red/green/yellow/blue/cyan/magenta/white) - - mindmap tag <id> <tag> — add a tag - -5. **Persistence:** - - mindmap save <name> — save to localStorage - - mindmap load <name> — restore - - mindmap list — show saved mindmaps - - mindmap delete <name> — remove saved - -6. **Export:** - - mindmap export [id] — Markdown bullet list output, auto-copies to clipboard - -7. **When to use:** - - Map out project structure, brainstorm features, organize ideas - - Break down complex tasks into subtrees - - User says "brainstorm", "diagram", "organize thoughts", "plan"
\ No newline at end of file diff --git a/skills/mindmap.md b/skills/mindmap.md new file mode 100644 index 0000000..e1cbb7b --- /dev/null +++ b/skills/mindmap.md @@ -0,0 +1,50 @@ +--- +name: mindmap +description: Create, manage, visualize, and persist brainstorming mindmaps using the mindmap terminal module. +tags: [mindmap, brainstorming, planning, organization, visualization] +category: productivity +--- + +## Core Workflow + +1. **Create a new mindmap** + - `mindmap new "<topic>" -t tag1,tag2` — creates a root node + - Tags are optional (e.g. planning, research, dev) + - Root gets auto-assigned a color from 7-color palette + +2. **Add child nodes** + - `mindmap add <parent-id> "<idea>" -t tag` — add a child + - Get parent-id from `mindmap show` — IDs are 4-char random strings + +3. **View** + - `mindmap show` — full tree with Unicode box-drawing + - `mindmap show <id>` — subtree starting at that node + - `mindmap svg [name]` — render as inline SVG with colored rects + bezier curves. Optional name saves to /mindmaps/<name>.svg for `preview` + +4. **Visualize with Mermaid** + - Export your mindmap data and render in `webx11_mindmap.html` for a full Mermaid flowchart + - The mermaid library is at `mermaid.min.js` in the newOS4 directory + +5. **Edit nodes** + - `mindmap rename <id> "<new text>"` — change text + - `mindmap color <id> <color>` — set color (red/green/yellow/blue/cyan/magenta/white) + - `mindmap tag <id> <tag>` — assign/update tag + +6. **Persistence** + - `mindmap save <name>` — save to VFS (stores in /mindmaps/ as JSON) + - `mindmap load <name>` — restore + - `mindmap list` — show saved mindmaps + - `mindmap delete <name>` — remove saved mindmap file + +7. **Export** + - `mindmap export [id]` — Markdown bullet list output, auto-copies to clipboard + - `mindmap svg <name>` — saves SVG to /mindmaps/<name>.svg, viewable with `preview` + +8. **Neural VFS integration** + - After running `nvfs-index`, mindmap skill files are indexed as `concept://mindmap` + - Saved mindmaps in /mindmaps/ are discoverable via concept search + +## When to Use +- Brainstorming feature sets, project architecture, or ideas +- Decomposing complex tasks into manageable subtrees +- User says "brainstorm", "diagram", "organize thoughts", "plan", "map out"
\ No newline at end of file diff --git a/skills/neural-vfs-indexer.md b/skills/neural-vfs-indexer.md new file mode 100644 index 0000000..0030db7 --- /dev/null +++ b/skills/neural-vfs-indexer.md @@ -0,0 +1,21 @@ +--- +name: neural-vfs-indexer +description: Scans the VFS to create semantic mappings between concepts and file paths. +tags: [neural-vfs, semantic, indexing, newos4] +category: system +--- + +# Neural VFS Indexer + +## Purpose +To implement the "Neural VFS" pillar of newOS4 by creating a semantic layer over the hierarchical filesystem. + +## Workflow +1. **Discovery**: List all files in the VFS using `list_files`. +2. **Analysis**: Read the contents of each file. +3. **Keyword Extraction**: Identify primary themes, technical terms, and "concepts" within the file. +4. **Indexing**: Create a mapping file in `.semantic_index/` named after the concept (e.g., `.semantic_index/cognitive-kernel.map`). +5. **Mapping**: The mapping file should contain the path to the source file and a brief semantic summary. + +## Usage +Run this skill when new documentation is added or when the architectural structure changes. diff --git a/skills/project-profile-manager.md b/skills/project-profile-manager.md index 03eead8..7b8c6cf 100644 --- a/skills/project-profile-manager.md +++ b/skills/project-profile-manager.md @@ -2,6 +2,7 @@ name: project-profile-manager description: Handles saving and loading of project-specific context bundles. tags: [context, memory, workspace] +category: system --- # Project Profile Manager diff --git a/skills/task-manager.md b/skills/task-manager.md index 74c3da1..f4a0542 100644 --- a/skills/task-manager.md +++ b/skills/task-manager.md @@ -2,6 +2,7 @@ name: task-manager description: A systematic approach to managing tasks using a JSON-based tracking system in the VFS. tags: productivity, management, organization +category: productivity --- # Task Management Workflow diff --git a/skills/webdav-operations.md b/skills/webdav-operations.md deleted file mode 100644 index 098449c..0000000 --- a/skills/webdav-operations.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -name: webdav-operations -description: How to use WebDAV cloud storage for backup, file sync, and remote file access -tags: [webdav, cloud, backup, sync, storage] -category: system ---- -## Steps -1. **Configuration:** - - webdav-config — configure WebDAV endpoint URL and credentials - - Connection auto-tested on config; webdav-status shows connection health - - Uses per-user token stored in .token file on the server side - -2. **File operations:** - - webdav-ls [path] — list remote directory contents - - webdav-push <local-path> <remote-path> — upload file to WebDAV - - webdav-pull <remote-path> [local-path] — download file from WebDAV - - webdav-explorer — GUI file browser for WebDAV - - webdav-browser — CLI file browser for WebDAV - -3. **Backup & Restore:** - - webdav-backup — push full VFS snapshot to WebDAV (creates /backups/newos4-<date>.json) - - webdav-backup-list — list all remote backup snapshots - - webdav-restore <filename> — restore VFS from a remote backup snapshot - -4. **Status & Diagnostics:** - - webdav-status — connection status, last sync, space information - - If uploads fail: check webdav-config, ensure .token file is valid - - WebDAV runs on the same server (nginx with WebDAV module), no external dependency - -5. **When to use:** - - Before factory-reset: webdav-backup to store VFS remotely - - Cross-browser: webdav-push/pull to move files between instances - - User says "cloud backup" or "remote save" → webdav-backup
\ No newline at end of file diff --git a/skills/webdav-sync.md b/skills/webdav-sync.md deleted file mode 100644 index ead86dd..0000000 --- a/skills/webdav-sync.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -name: webdav-sync -description: Sync, backup, and restore VFS via WebDAV in WebX11. CRITICAL: Only use verified commands. -category: system -tags: [webdav, sync, backup, cloud, vfs] ---- - -# WebDAV Sync Workflow - -## ⚠️ CRITICAL RULE: VERIFY BEFORE EXECUTING -**ALWAYS run `help <command>` first.** -**If `help <command>` returns nothing, the command does NOT exist.** -**Never invent commands — terminal crashes.** - -## 1. Install & Configure -- `webdav-config` — configure WebDAV connection -- `webdav-status` — verify connection - -## 2. Verified Commands ONLY -| Command | Verify With | Purpose | -|---------|-------------|---------| -| `webdav-ls` | `help webdav-ls` | List files on server | -| `webdav-backup` | `help webdav-backup` | Backup VFS to WebDAV | -| `webdav-backup-list` | `help webdav-backup-list` | List backups | -| `webdav-restore` | `help webdav-restore` | Restore from backup | -| `webdav-push` | `help webdav-push` | Push VFS to server | -| `webdav-pull` | `help webdav-pull` | Pull from server | - -## 3. What Does NOT Exist -There is **NO CLI delete** for WebDAV files. These will CRASH: -- `webdav-browser` ❌ -- `webdav-explorer` ❌ -- `webdav-delete` ❌ -- `webdav-rm` ❌ - -## 4. Deleting Files -Since `curl` is also blocked, there is **no automated way** to delete WebDAV backups from the terminal. Use the WebDAV web interface outside the terminal. - -## 5. For VFS Files (local filesystem) -Use `rm <file>` — this is a real command. Verify: `help rm`
\ No newline at end of file diff --git a/skills/webdav.md b/skills/webdav.md new file mode 100644 index 0000000..c8b2dfc --- /dev/null +++ b/skills/webdav.md @@ -0,0 +1,44 @@ +--- +name: webdav +description: Configure, sync, backup, and restore VFS via WebDAV cloud storage. +tags: [webdav, cloud, backup, sync, storage, vfs] +category: system +--- + +## CRITICAL: VERIFY BEFORE EXECUTING +**ALWAYS run `help <command>` first.** If `help <command>` returns nothing, the command does NOT exist. Never invent commands — terminal crashes. + +## 1. Configure & Status +- `webdav-config` — configure WebDAV endpoint URL and credentials +- `webdav-status` — verify connection health, last sync, space info + +## 2. File Operations + +| Command | Purpose | +|---------|---------| +| `webdav-ls [path]` | List remote directory contents | +| `webdav-push <local> <remote>` | Upload file to WebDAV | +| `webdav-pull <remote> [local]` | Download file from WebDAV | + +## 3. Backup & Restore +- `webdav-backup` — push full VFS snapshot to WebDAV (`/backups/newos4-<date>.json`) +- `webdav-backup-list` — list all remote backup snapshots +- `webdav-restore <filename>` — restore VFS from remote backup + +## 4. What Does NOT Exist +These will crash the terminal: +- `webdav-browser` ❌ +- `webdav-explorer` ❌ +- `webdav-delete` ❌ +- `webdav-rm` ❌ + +Since `curl` is also blocked, no automated way to delete WebDAV backups from the terminal — use the WebDAV web interface outside. + +## 5. When to Use +- Before factory-reset: `webdav-backup` to store VFS remotely +- Cross-browser: `webdav-push`/`webdav-pull` to move files +- User says "cloud backup" or "remote save" + +## 6. Connection Details +- Uses per-user token stored in `.token` file on the server +- WebDAV runs on same server (nginx with WebDAV module) — no external dependency
\ No newline at end of file diff --git a/skills/webx11-dev-cycle.md b/skills/webx11-dev-cycle.md index 66fefde..934b65b 100644 --- a/skills/webx11-dev-cycle.md +++ b/skills/webx11-dev-cycle.md @@ -9,4 +9,5 @@ steps: 5. Document: Save the final implementation and a a changelog in /webx11_dev/logs/. 6. Persist: Save the session using session_save. tags: development,workflow,webx11 +category: dev --- |