jd-sub-index

Johnny.Decimal +SUB Index Manager

This skill maintains +SUB index files within categories that use the AC.ID+NNNN or AC.ID+CODE extension pattern. It keeps index files in sync with the actual +SUB folders and helps create new entries.

---

1. Understand +SUB Extensions

+SUB extends the AC.ID notation for items that repeat across many instances within a single ID.

Numeric +SUB: AC.ID+NNNN

Zero-padded four-digit sequential number:

53.01+0001  weather-api
53.01+0002  task-runner
53.01+0003  auth-dashboard

Named +SUB: AC.ID+CODE

Short alphanumeric code:

11.01+REDD  The Red Door
11.01+OAKS  Oak Street Cafe
11.01+RIVR  Riverside Grill

When Each Format is Used

Numeric +NNNN	Named +CODE
Items are primarily sequential	Items have natural short codes
No inherent abbreviation	Abbreviations are obvious and useful
Expect many entries (20+)	Expect fewer, memorable entries
Example: projects, trips, campaigns	Example: accounts, venues, people

---

2. Locate +SUB Categories

2.1 Find the System

Check common JD root locations and identify the target system. If the user specifies a system code and category, go directly there. Otherwise, scan for +SUB categories.

2.2 Identify +SUB Categories

A category uses +SUB if it contains folders matching the pattern:

AC.ID+NNNN Description/
AC.ID+CODE Description/

Scan the system's categories and list those with +SUB folders.

2.3 Find the Index File

Each +SUB category should have an index file. Common patterns:

• AC.ID [Category] index.md (e.g., 51.01 Open-source project index.md)
• AC.00 [Category] index.md (e.g., 51.00 Projects area index.md)

If no index file exists, offer to create one.

---

3. Scan Existing Entries

List all +SUB folders within the target category/ID. For each entry, capture:

• The +SUB identifier (number or code)
• The description (from folder name)
• Whether the folder contains content or is empty
• Creation date (from folder metadata or earliest file date)