smithery/alexanderop

update-system-map

Update the System Knowledge Map documentation

Installation

$ npx skills add smithery/alexanderop --skill update-system-map

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery/alexanderop · top by installs.

npx skills add smithery/alexanderop

Browse all from smithery/alexanderop

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsRead, Write, Edit, Glob, Grep, Bash, Task

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,474 B
  • docs SUMMARY.md 70 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Update System Knowledge Map

Perform a codebase archaeology investigation and update docs/SYSTEMKNOWLEDGEMAP.md with current system state.

Investigation Plan

Phase 1: Reconnaissance (Tech Stack)

  1. Read package.json for dependencies and scripts
  2. Read nuxt.config.ts for framework configuration
  3. List app/ directory structure

Phase 2: Data Model Discovery (The Nouns)

  1. Read content.config.ts for collection schemas and content types
  2. Count items in content/, content/authors/, content/podcasts/
  3. Identify any new entity types or schema changes

Phase 3: Capabilities Discovery (The Verbs)

  1. List app/pages/ for route handlers
  2. List server/api/ for API endpoints
  3. Read key pages to understand features
  4. List app/composables/ for reusable logic

Phase 4: Business Rules

  1. Grep for validation logic in content.config.ts
  2. Check for any new business rules in server/api handlers
  3. Review any constants or config files

Phase 5: Generate Report

Update docs/SYSTEMKNOWLEDGEMAP.md with:

# System Knowledge Map

> Auto-generated codebase archaeology report for non-technical stakeholders
> Last updated: [current date]

## 1. High-Level Overview

- What this system does (1-2 sentences)
- Tech stack table

## 2. Core Business Entities (The Nouns)

- Content (with all type variants and key attributes)
- Authors
- Podcasts
- Tweets
- Any new entities

## 3. Key Capabilities (The Verbs)

- Content management features
- Discovery & navigation features
- Visualization features
- Reading experience features

## 4. Business Rules & Logic

- Validation rules with file:line references
- Workflows (e.g., reading status)
- Naming conventions

## 5. Integrations

- External services
- Internal modules

## 6. API Surface

- All endpoints with methods and purposes

## 7. File Structure

- Key directories and their purposes

## 8. Current Scale

- Approximate counts of content, authors, etc.

Important Guidelines

  • Be thorough: Read actual files, don't assume
  • Include counts: Provide real numbers for scale section
  • Add line references: For business rules, include file.ts:line
  • Update timestamp: Always update the "Last updated" date
  • Preserve structure: Keep the same section headings for consistency