name	master-index-updater
description	Automates updates to the Functional Area Master Index when new features are added or documentation changes. Maintains the single navigation source for all feature documentation, ensuring discoverability and organization.

Master Index Updater Skill

Purpose: Automate updates to Functional Area Master Index when features or documentation change.

When to Use: After creating new functional area documentation or completing feature work.

Why the Master Index Matters

Problem: Documentation scattered across /docs/functional-areas/ becomes undiscoverable.

Solution: Single navigation index at /docs/architecture/functional-area-master-index.md

Result: All documentation discoverable, organized by domain, with status tracking.

Master Index Structure

Location: /docs/architecture/functional-area-master-index.md

Organization:

# Functional Area Master Index

## Core System
- Authentication & Authorization
- User Management
- Profile Management

## Events Domain
- Event Management
- Session Management
- Registration System

## Content & Community
- Teacher Bios
- Event Catalog
- Venue Management

## Operations
- Safety & Reporting
- Payment Processing
- Communication System

[For each area:]
## Feature Name

**Domain**: Core System | Events | Content | Operations
**Status**: Active | Deprecated | Planned
**Owner**: Team/Agent
**Last Updated**: YYYY-MM-DD

### Documentation
- [Business Requirements](./path/to/requirements.md)
- [Functional Spec](./path/to/functional-spec.md)
- [API Documentation](./path/to/api-docs.md)

### Key Files
- Feature Code: `/apps/web/src/features/feature-name/`
- API Endpoints: `/apps/api/Features/FeatureName/`
- Tests: `/tests/playwright/feature-name*.spec.ts`

### Related Areas
- [Related Feature 1](#feature-1)
- [Related Feature 2](#feature-2)

Update Types

1. New Feature Addition

When new feature is completed:

Add entry to appropriate domain section
Link all documentation
List key files
Set status: Active
Update last modified date

2. Feature Status Update

When feature changes:

Update status (Active → Deprecated)
Add migration notes if deprecated
Update last modified date

3. Documentation Addition

When new docs created:

Add links to existing feature entry
Update documentation section
Update last modified date

4. Domain Reorganization

When functional areas restructure:

Move entries to new domains
Update navigation structure
Preserve all links

Automated Updater Script

#!/bin/bash
# Master Index Updater Script

ACTION="$1"  # add|update|deprecate
FEATURE_NAME="$2"
DOMAIN="$3"
FEATURE_PATH="$4"

MASTER_INDEX="/home/chad/repos/witchcityrope/docs/architecture/functional-area-master-index.md"

if [ ! -f "$MASTER_INDEX" ]; then
    echo "❌ Error: Master Index not found at $MASTER_INDEX"
    exit 1
fi

echo "Master Index Updater"
echo "===================="
echo "Action: $ACTION"
echo "Feature: $FEATURE_NAME"
echo "Domain: $DOMAIN"
echo ""

# Create backup
cp "$MASTER_INDEX" "${MASTER_INDEX}.backup"

TIMESTAMP=$(date +"%Y-%m-%d")

case "$ACTION" in
    "add")
        # Add new feature entry
        echo "Adding new feature to Master Index..."

        # Find domain section
        DOMAIN_SECTION=$(grep -n "^## $DOMAIN" "$MASTER_INDEX" | cut -d: -f1)

        if [ -z "$DOMAIN_SECTION" ]; then
            echo "❌ Error: Domain not found: $DOMAIN"
            echo "   Valid domains: Core System, Events Domain, Content & Community, Operations"
            exit 1
        fi

        # Create feature entry
        FEATURE_ENTRY="
### $FEATURE_NAME

**Domain**: $DOMAIN
**Status**: ✅ Active
**Owner**: WitchCityRope Team
**Last Updated**: $TIMESTAMP

#### Documentation
- [Business Requirements]($FEATURE_PATH/new-work/*/requirements/business-requirements.md)
- [Functional Spec]($FEATURE_PATH/new-work/*/requirements/functional-spec.md)
- [Database Design]($FEATURE_PATH/new-work/*/design/database-design.md)
- [UI/UX Design]($FEATURE_PATH/new-work/*/design/ui-ux-design.md)

#### Key Files
- Feature Code: \`/apps/web/src/features/$(echo $FEATURE_NAME | tr '[:upper:]' '[:lower:]' | tr ' ' '-')/\`
- API Endpoints: \`/apps/api/Features/$(echo $FEATURE_NAME | tr ' ' '')/\`
- Tests: \`/tests/playwright/$(echo $FEATURE_NAME | tr '[:upper:]' '[:lower:]' | tr ' ' '-')*.spec.ts\`

#### Status Notes
- Recently implemented
- All tests passing
- Documentation complete

---
"

        # Insert after domain header
        LINE_NUM=$((DOMAIN_SECTION + 1))
        {
            head -n $LINE_NUM "$MASTER_INDEX"
            echo "$FEATURE_ENTRY"
            tail -n +$((LINE_NUM + 1)) "$MASTER_INDEX"
        } > "${MASTER_INDEX}.tmp"

        mv "${MASTER_INDEX}.tmp" "$MASTER_INDEX"

        echo "✅ Feature added to Master Index"
        echo "   Domain: $DOMAIN"
        echo "   Feature: $FEATURE_NAME"
        ;;

    "update")
        # Update existing feature
        echo "Updating feature in Master Index..."

        # Find feature section
        if ! grep -q "^### $FEATURE_NAME" "$MASTER_INDEX"; then
            echo "❌ Error: Feature not found: $FEATURE_NAME"
            exit 1
        fi

        # Update Last Updated timestamp
        sed -i '' "s/^\*\*Last Updated\*\*: .*/*\*Last Updated**: $TIMESTAMP/" "$MASTER_INDEX" 2>/dev/null || \
        sed -i "s/^\*\*Last Updated\*\*: .*/*\*Last Updated**: $TIMESTAMP/" "$MASTER_INDEX"

        echo "✅ Feature updated in Master Index"
        echo "   Last Updated: $TIMESTAMP"
        ;;

    "deprecate")
        # Mark feature as deprecated
        echo "Deprecating feature in Master Index..."

        # Find feature and update status
        if ! grep -q "^### $FEATURE_NAME" "$MASTER_INDEX"; then
            echo "❌ Error: Feature not found: $FEATURE_NAME"
            exit 1
        fi

        # Change status to deprecated
        sed -i '' "/^### $FEATURE_NAME/,/^---/ s/\*\*Status\*\*: .*/\*\*Status**: ⚠️  Deprecated/" "$MASTER_INDEX" 2>/dev/null || \
        sed -i "/^### $FEATURE_NAME/,/^---/ s/\*\*Status\*\*: .*/\*\*Status**: ⚠️  Deprecated/" "$MASTER_INDEX"

        # Update timestamp
        sed -i '' "/^### $FEATURE_NAME/,/^---/ s/\*\*Last Updated\*\*: .*/\*\*Last Updated**: $TIMESTAMP/" "$MASTER_INDEX" 2>/dev/null || \
        sed -i "/^### $FEATURE_NAME/,/^---/ s/\*\*Last Updated\*\*: .*/\*\*Last Updated**: $TIMESTAMP/" "$MASTER_INDEX"

        echo "✅ Feature marked as deprecated"
        echo "   Add migration notes to Status Notes section"
        ;;

    *)
        echo "❌ Error: Unknown action: $ACTION"
        echo "   Valid actions: add, update, deprecate"
        exit 1
        ;;
esac

# Update index last modified date
sed -i '' "1,10s/Last Updated: .*/Last Updated: $TIMESTAMP/" "$MASTER_INDEX" 2>/dev/null || \
sed -i "1,10s/Last Updated: .*/Last Updated: $TIMESTAMP/" "$MASTER_INDEX"

echo ""
echo "✅ Master Index updated successfully"
echo "   Location: $MASTER_INDEX"
echo "   Backup: ${MASTER_INDEX}.backup"

Usage Examples

From Librarian Agent (Automated)

After organizing feature documentation, I'll use the master-index-updater skill to add the feature to the index.

Manual Addition

# Add new feature
bash .claude/skills/master-index-updater.md \
  add \
  "Streamlined Check-in Workflow" \
  "Events Domain" \
  "docs/functional-areas/events/new-work/2025-11-03-streamlined-checkin-workflow"

Update Existing Feature

# Update feature timestamp
bash .claude/skills/master-index-updater.md \
  update \
  "Event Management" \
  "" \
  ""

Deprecate Feature

# Mark feature as deprecated
bash .claude/skills/master-index-updater.md \
  deprecate \
  "Legacy Registration System" \
  "" \
  ""

Domain Classification

Core System

Characteristics:

Foundational functionality
Used across multiple features
Authentication, users, profiles

Examples:

Authentication & Authorization
User Management
Profile Management
Role-Based Access Control

Events Domain

Characteristics:

Event lifecycle management
Primary business functionality
Classes, workshops, performances

Examples:

Event Management
Session Management
Registration System
Attendance Tracking

Content & Community

Characteristics:

Content management
Community features
Public-facing information

Examples:

Teacher Bios
Event Catalog
Venue Management
Member Directory

Operations

Characteristics:

Administrative features
Backend operations
Support functions

Examples:

Safety & Reporting
Payment Processing
Communication System
Analytics & Reporting

Entry Template

### Feature Name

**Domain**: [Core System | Events Domain | Content & Community | Operations]
**Status**: [✅ Active | ⚠️  Deprecated | 🔵 Planned | 🚧 In Progress]
**Owner**: WitchCityRope Team
**Last Updated**: YYYY-MM-DD

#### Documentation
- [Business Requirements](./path/to/business-requirements.md)
- [Functional Spec](./path/to/functional-spec.md)
- [Database Design](./path/to/database-design.md)
- [UI/UX Design](./path/to/ui-ux-design.md)
- [Implementation Notes](./path/to/implementation-notes.md)
- [Testing Notes](./path/to/testing-notes.md)

#### Key Files
- Feature Code: `/apps/web/src/features/feature-name/`
- API Endpoints: `/apps/api/Features/FeatureName/`
- Database: `/apps/api/Data/Entities/FeatureName.cs`
- Tests: `/tests/playwright/feature-name*.spec.ts`

#### Related Areas
- [Related Feature 1](#related-feature-1)
- [Related Feature 2](#related-feature-2)

#### Status Notes
- [Current status description]
- [Known issues or limitations]
- [Migration notes if deprecated]

---

Integration with Librarian Agent

Librarian is responsible for:

Creating new functional area folders
Organizing documentation
Updating Master Index (uses this skill)
Maintaining navigation structure

Workflow:

Librarian organizes documentation
Librarian uses master-index-updater skill
Master Index updated with new feature
Documentation becomes discoverable

Validation Rules

Before Adding Entry

Feature documentation exists
Domain is correct (Core/Events/Content/Operations)
No duplicate entries
All documentation links valid
Key files paths accurate

After Adding Entry

Entry appears in correct domain
All links work
Last Updated timestamp correct
Navigation preserved
Alphabetical order maintained (if applicable)

Common Issues

Issue: Wrong Domain Classification

Problem: Feature added to wrong domain Impact: Confusing navigation Solution: Move entry to correct domain, update related links

Issue: Broken Documentation Links

Problem: Links point to non-existent files Impact: Users can't find documentation Solution: Validate links before adding, fix broken links

Issue: Duplicate Entries

Problem: Feature added multiple times Impact: Confusing navigation Solution: Check for existing entry before adding

Issue: Stale Entries

Problem: Deprecated features not marked Impact: Users try to use old features Solution: Regular audit, mark deprecated features

Maintenance Tasks

Weekly

Validate all links work
Check for new features without index entries
Update timestamps for modified features

Monthly

Review deprecated features for removal
Reorganize if domain structure changes
Consolidate related features

Quarterly

Complete navigation audit
Update domain definitions
Archive truly obsolete features

Output Format

{
  "masterIndexUpdate": {
    "action": "add",
    "feature": "Streamlined Check-in Workflow",
    "domain": "Events Domain",
    "status": "Active",
    "timestamp": "2025-11-04",
    "documentation": [
      "business-requirements.md",
      "functional-spec.md",
      "database-design.md",
      "ui-ux-design.md"
    ],
    "location": "/docs/architecture/functional-area-master-index.md",
    "section": "## Events Domain",
    "backup": "/docs/architecture/functional-area-master-index.md.backup"
  },
  "nextSteps": [
    "Verify all documentation links work",
    "Add related area cross-references",
    "Update PROGRESS.md with new feature"
  ]
}

Progressive Disclosure

Initial Context: Show action and feature name On Request: Show full entry being added/updated On Completion: Show location and backup path On Failure: Show validation errors and required fixes

Remember: The Master Index is the entry point for all feature documentation. Without it, documentation is invisible. With it, every feature is discoverable, organized, and maintainable. This skill automates keeping it current.

master-index-updater

Install Skill

SKILL.md

Master Index Updater Skill

Why the Master Index Matters

Master Index Structure

Update Types

1. New Feature Addition

2. Feature Status Update

3. Documentation Addition

4. Domain Reorganization

Automated Updater Script

Usage Examples

From Librarian Agent (Automated)

Manual Addition

Update Existing Feature

Deprecate Feature

Domain Classification

Core System

Events Domain

Content & Community

Operations

Entry Template

Integration with Librarian Agent

Validation Rules

Before Adding Entry

After Adding Entry

Common Issues

Issue: Wrong Domain Classification

Issue: Broken Documentation Links

Issue: Duplicate Entries

Issue: Stale Entries

Maintenance Tasks

Weekly

Monthly

Quarterly

Output Format

Progressive Disclosure