skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

update-workspace-map

Validates workspace-map.md against the actual 04-workspace folder structure and reports discrepancies.

Updated Jan 22, 2026
Search Tags:#automation#documentation#markdown#file organization#validation#workspace#folder structure
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill update-workspace-map-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-workspace-map
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/system/update-workspace-map
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill update-workspace-map-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? When folders in your 04-workspace/ directory are added, removed, or reorganized without updating workspace-map.md, the AI loses its ability to navigate your files reliably. This Skill keeps the documentation synchronized with the real folder structure. ## Core Features & Use Cases - Deep Structure Scanning: Scans the workspace up to 3 levels deep, detecting folders, subfolders, and important Markdown files. - Discrepancy Detection: Compares actual folders against documented entries and identifies missing folders, stale entries, and hierarchy mismatches. - Guided Updates: Walks you through documenting new folders and removing stale entries, then re-validates the result. - Use Case: After reorganizing client folders in 04-workspace/, run validation to confirm workspace-map.md still matches reality and fix any drift before the AI starts using outdated paths. ## Quick Start Say "validate workspace map" to scan your 04-workspace folder and check that workspace-map.md accurately reflects the current structure.

Frequently Asked Questions about update-workspace-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a workspace map against my folder structure?▼

Run the validate-workspace.py script or say "validate workspace map" to trigger the check. It scans 04-workspace/ up to 3 levels deep, parses workspace-map.md, and outputs a JSON report listing missing folders, stale entries, and recommendations.

How does the workspace map validation script detect documented folders?▼

The script parses workspace-map.md using three methods: tree structure patterns (├── and └──), folder headings (### FolderName/), and folder mentions ending with a slash. This multi-method approach handles variations in map formatting.

When does workspace map validation run automatically?▼

Validation runs automatically during the close-session workflow at every session end, and during onboarding in Project 03, Task 5.6. It stays silent when the map matches the actual structure and only prompts when mismatches are found.

What folders are excluded from workspace validation scans?▼

The scan excludes hidden folders (starting with a dot, such as .git and .vscode), the workspace-map.md file itself, and system or temporary files. Folders without read permission are skipped and logged in the report.

What do the exit codes of validate-workspace.py mean?▼

Exit code 0 means the map is valid and matches the workspace. Exit code 1 means updates are needed due to missing or stale entries. Exit code 2 indicates an error occurred, such as a missing workspace root.

Related Skills

Explore More Product & Management Skills→
beam-ai-teambeam-ai-team

setup-workspace

Organize 04-workspace folders and generate workspace-map.md with progress flags.

Official
Intermediate
abdullahbeamabdullahbeam
2

update-workspace-map

Validates workspace-map.md against the actual 3-level deep folder structure of 04-workspace/.

Community
Intermediate
jellyrockjellyrock
37

end-session

Update project plans with git-verified progress and draft next-session handoffs.

Official
Advanced
synthesisengineeringsynthesisengineering
15

synthesis-context-lifecycle

Implement a tiered context architecture with CONTEXT.md, REFERENCE.md, and sessions/ archives.

Official
Advanced