Skip to content

johnfkoo951/cmds-system-files

Repository files navigation

CMDS System Files

5 Core System Files + 5 Shared Rules + 9 Architecture Patterns that power the CMDSPACE Personal Knowledge Management ecosystem.

Live Demo

https://system.cmdspace.work

Overview

CMDS (CMDSPACE) is a comprehensive Personal Knowledge Management (PKM) system built on Obsidian with 10,000+ notes. This repository contains the core system files that provide complete guidance for AI agents and human users working with the vault.

What's New in v4.2 (2026-04-15)

  • CMDS Process Command Suite — 8 slash commands aligned with Connect / Merge / Develop / Share
    • Stage commands: /connect, /merge, /develop, /share
    • Cross-cutting utilities: /inbox (router), /lint, /query, /status
  • Design principles:
    • /inbox is router-only (scans 9 inbox subfolders, routes via AskUserQuestion)
    • /share is orchestrator-only (delegates to existing skills — thebetter-writer, markdown-slides, etc.)
    • /query results classify into CMDS categories — no separate folder
  • 10 new camelCase frontmatter fields: mergePurpose, sourceNotes, mainVaultRelated, developSources, shareSourceNotes, shareFormat, sharePurpose, queryOrigin, querySources, sourceInbox

Previous Highlights

  • v4.1 (2026-04-07) — description field (English, LLM relevance hint) added as required property; 7 required properties total
  • v4.0 (2026-04-01) — Shared rules (.claude/rules/) via @include; 9 architecture patterns; enhanced frontmatter (precedence, memory-type, token-estimate, etc.)
  • v3.0 (2026-03-15) — Structured YAML frontmatter; share system with placeholder rules
  • v2.0 (2026-01-20) — 5-file architecture (CLAUDE.md, AGENTS.md, CMDS.md, CMDS Guide, CMDS Head Quarter)
  • v1.0 (2025-10-01) — Initial system files

See CHANGELOG.md for full history.

Repository Structure

files/
├── CLAUDE.md              # Claude Code technical guide (precedence: 1)
├── AGENTS.md              # Other AI agents guide (precedence: 2)
├── CMDS.md                # System philosophy for all LLMs (precedence: 3)
├── CMDS-Guide.md          # Operational standards (precedence: 4)
├── CMDS-Head-Quarter.md   # Navigation hub (precedence: 5)
└── CMDS-System-Files.zip  # All files bundled

rules/
├── indentation-rules.md        # YAML 2-spaces / Markdown TAB
├── frontmatter-standard.md     # 7 required properties + format
├── file-creation-rules.md      # Output path, naming, project folders
├── wikilink-rules.md           # Obsidian wikilink syntax + YAML quoting
├── directory-structure.md      # Vault folder structure + CMDS categories
├── mermaid-rules.md            # Mermaid diagram quoting rules (Obsidian)
└── video-project-workflow.md   # Remotion / video project placement rules

CHANGELOG.md               # Version history

The 5 Core Files

For AI Agents (loaded into context window)

File Audience Focus Precedence
CLAUDE.md Claude Code Technical implementation (HOW) 1
AGENTS.md Gemini, Codex, Cursor Portable technical rules (HOW) 2
CMDS.md All LLM assistants Context & philosophy (WHY/WHAT) 3

For Humans (referenced in Obsidian)

File Audience Focus Precedence
CMDS Guide User + AI Operational standards 4
CMDS Head Quarter User Navigation hub 5

Architecture Patterns (from Claude Code Source Analysis)

# Pattern Purpose
1 precedence File priority ordering (1-5) for conflict resolution
2 STATIC/DYNAMIC Cache-aware sections for AI processing
3 @include Shared rules via file inclusion (AI reads inline)
4 Essential Post-compact recovery — core rules that survive context compression
5 required-for/optional-for Agent scoping — which tasks need which files
6 memory-type Maps to Claude Code's memdir types (feedback/user/reference)
7 token-estimate Token budget awareness for AI load prioritization
8 changelog Inline version history in each file's frontmatter
9 shared rules Common rules in .claude/rules/ shared via @include

@include vs [[wikilink]]

Syntax Purpose Used By
@path AI reads file content inline AI agents (Claude Code, etc.)
[[name]] Obsidian internal link for navigation Obsidian graph view, backlinks
Both together @file → [[file]] When both AI loading and human navigation needed

CMDS Process

Connect → Merge → Develop → Share
Stage Categories What Happens
Connect 100 Themes Discover ideas, capture interests
Merge 200 Literature Integrate knowledge, build theory
Develop 300-600 Collect data, apply methods, use tools
Share 700-800 Create content, publish, teach, consult

Getting Started

  1. Download all files from system.cmdspace.work
  2. Place system files in the root of your Obsidian vault
  3. Place rules in .claude/rules/ directory
  4. Customize placeholders ({your-name}, {vault-path}, etc.)
  5. Reference CMDS.md in your AI conversations for context

Stats

Metric Value
Core System Files 5
Shared Rules 7
Slash Commands (CMDS Process) 8
Architecture Patterns 9
Required Frontmatter Properties 7
CMDS Categories 9 (100-900)
Subcategories 91
Vault Notes 10,000+

Download

Links

License

All intellectual property rights belong to CMDSPACE.


Last Updated: 2026-04-15 · v4.2

About

Knowledge architecture for a 10,000-note Obsidian vault — 5 system files + 7 shared rules + 8 slash commands, shared openly with humans and AI agents. Live: https://system.cmdspace.work

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors