semantic-docs

Semantic Documentation Navigator

Search business-logic-to-code mappings in docs/semantic/.

Quick Commands

Find by Logic ID:

$SKILL_DIR/scripts/find-logic-id.sh AUTH-L2

Returns: code location, file path, complexity

Find by Feature:

$SKILL_DIR/scripts/find-feature.sh ACCS

Returns: full technical spec

Find Entity Schema:

$SKILL_DIR/scripts/find-entity.sh user

Returns: JSON schema with fields and relationships

Find User Story:

$SKILL_DIR/scripts/find-user-story.sh US-004

Returns: user story with linked Logic IDs

List All Features:

$SKILL_DIR/scripts/list-features.sh

Returns: feature registry table from business index

Trace Code Location:

$SKILL_DIR/scripts/trace-code.sh ARCH-L1

Returns: exact file:line:function for implementation

Documentation Structure

docs/semantic/
├── 00_BUSINESS_INDEX.md        # Master index (read first for overview)
├── tech/*.md                   # Technical specs by feature
├── schemas/*.base-fields.json  # Base field schemas (auto-generated from PHP)
├── schemas/*.BUNDLE.json       # Config field schemas (auto-generated from YAML)
├── schemas/*.business.json     # Business schemas (AI-authored: rules, relationships, examples)
└── SUMMARY.md                  # Quick reference (if available)

Schema types:

• *.base-fields.json — Base fields from PHP baseFieldDefinitions(). Auto-generated by structural index.
• *.BUNDLE.json — Config fields from YAML (field.storage.*.yml + field.field.*.yml). Auto-generated.
• *.business.json — Business rules, related entities, and examples. AI-authored by @semantic-architect. Contains NO field definitions.

Logic ID Format

Each tech spec contains Logic IDs that map business logic to code. Always use Logic IDs when referencing implementations — never guess file paths.

Logic IDs follow the pattern: FEATURE-L#

• FEATURE: 3-4 letter feature code
• L: Literal "L" for "Logic"
• #: Sequential number

Examples: AUTH-L1, ACCS-L3, MIGR-L10

Common Drupal Feature Codes

Code	Feature Domain
AUTH	Authentication & Login
ACCS	Access Control
CONT	Content Types
MIGR	Migrations
VIEW	Views & Displays
FORM	Forms & Validation
BLOC	Blocks & Regions
CACH	Caching
THEM	Theming
HOOK	Hook Implementations
SERV	Services
PLUG	Plugins
ROUT	Routing
CONF	Configuration

When This Skill Triggers

• "Where is [business rule] implemented?"
• "What does [Logic ID] do?"
• "Show me the [feature] technical spec"
• "What fields does [entity] have?"
• "How does [workflow] execute?"
• "Which code handles [user story]?"
• "List all features"
• "Find [module] code locations"

Manual Search

If scripts don't find what you need:

# Search business index
grep -i "keyword" docs/semantic/00_BUSINESS_INDEX.md

# Search all tech docs
grep -r "keyword" docs/semantic/tech/

# List available features
ls docs/semantic/tech/*.md | sed 's/.*\///' | sed 's/_.*$//' | sort -u

# List available schemas
ls docs/semantic/schemas/*.json | sed 's/.*\///' | sed 's/\.json$//'

Advanced Search

For grep patterns and complex queries, see SEARCH.md. For entity schema details, see ENTITY-LOOKUP.md.