Ganbin

4D Skill v21 — Implementation Plan

Development community intermediate

SOURCE https://github.com/Ganbin/4d-development-skill

Description

**Skill**: `4d-v21` **Target**: 4D v21 (single version) **Location**: `~/.claude/skills/4d-v21/` **Docs source**: `~/4D Resources/docs/docs` (48MB, 3,387 files) ---

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for Ganbin/4d-development-skill, shared by 2 entries in this directory. It describes the repository, not this entry specifically.

4D Skill v21 — Implementation Plan

**Skill**: `4d-v21` **Target**: 4D v21 (single version) **Location**: `~/.claude/skills/4d-v21/` **Docs source**: `~/4D Resources/docs/docs` (48MB, 3,387 files)

Architecture Overview

~/.claude/skills/4d-v21/
├── SKILL.md                        # Tier 1: Router, critical rules, docs navigator
├── plan.md                         # This file (implementation tracking)
├── references/                     # Tier 2: Curated knowledge + generated indexes
│   ├── [curated files]             #   Hand-written, comprehensive core content
│   ├── [index files]               #   Script-generated, navigation maps
│   └── manual-insights.md          #   Preserved user feedback from real usage
├── scripts/                        # Index generation tooling
│   └── generate-indexes.py         #   Parses docs/ and generates index files
├── docs/                           # Tier 3: Full official 4D v21 docs (copied)
│   ├── API/                        #   44 class reference files
│   ├── Concepts/                   #   30 foundational concept files
│   ├── commands/                   #   69 command files + 78 theme files
│   ├── commands-legacy/            #   1,213 legacy command files
│   ├── ORDA/                       #   12 ORDA documentation files
│   ├── REST/                       #   38 REST API files
│   ├── Events/                     #   63 form event files
│   ├── FormObjects/                #   56 form object files
│   ├── WebServer/                  #   16 web server files
│   └── ... (all other categories)
└── local/                          # Project-specific overrides (gitignored)
    └── README.md                   #   Template for project customizations

Three-Tier Funnel

Tier	What	When loaded	Size
1: SKILL.md	Critical rules, routing table, docs navigator	When skill triggers	~400-500 lines
2: references/	Curated knowledge + index maps	On demand by Claude	~8-12 files, each 100-400 lines
3: docs/	Full official 4D v21 documentation	Specific files read on demand	3,387 files, 48MB

Core Principle

**"Prefer retrieval-led reasoning over pre-training-led reasoning for any 4D task."** Claude should read the documentation files rather than rely on training data.

Phase 0: Setup & Preparation

0.1 — Create directory structure

Create the skill directory at ~/.claude/skills/4d-v21/
Create subdirectories: references/, scripts/, local/, docs/
Create local/README.md with template explaining how to add project-specific conventions
Create .gitignore that excludes local/* except local/README.md and excludes docs/ (large, sourced externally)

**How**: Run `mkdir -p` for each directory. Write a simple README.md template in `local/`. The `.gitignore` should contain:

local/*
!local/README.md
docs/

This keeps `docs/` out of git (it's sourced from the d