Internal Documentation Navigation Hub

Purpose: Internal development team navigation for restructured documentation Audience: Agents, developers, architects, and internal contributors Public Documentation: See README.md for pmorgan.tech public site

Last Updated: September 20, 2025 Status: ✅ Complete Internal Navigation System - Role-based access for development teams

Note: This navigation serves internal development workflows. For public project information, getting started guides, and user documentation, visit the main README.md which powers the pmorgan.tech website.

🚀 Quick Start by Role

Essential Briefings (Start Here)

Progressive Loading

Each essential briefing includes triggers for loading detailed documentation as needed.

🧭 Quick Navigation by Role

👨‍💼 Product Managers

🏗️ Architects

👨‍💻 Developers

📚 Researchers & Historians

👥 External Users

📁 Documentation Architecture

🔓 Public Documentation (public/)

External-facing content for users and developers

🔒 Internal Documentation (internal/)

Working documents for active development

Development (internal/development/)

├── active/                    # Current work by status
│   ├── in-progress/          # Active development
│   ├── pending-review/       # Files needing review
│   └── ready-for-integration/ # Completed work
├── methodology-core/         # 20 development methodologies (see INDEX.md)
├── tools/                    # Development tools and guides
├── handoffs/                 # Agent coordination prompts
└── planning/                 # Current planning cycles

Architecture (internal/architecture/)

├── current/                   # Active architectural decisions
│   ├── models/               # Hub-and-spoke model docs (39 models)
│   ├── adrs/                 # Current ADRs
│   ├── patterns/             # Established patterns
│   └── [core-specs]          # API, technical specifications
├── evolution/                # Architectural evolution tracking
└── decisions/                # Decision logs and rationale

Architecture Patterns

Developer Guides

Examples

Planning (internal/planning/)

├── current/                  # Active planning cycle
│   ├── data/                 # Planning data and analysis
│   ├── draft-issues/         # Issue development
│   ├── editorial/            # Content planning
│   └── integration/          # Integration planning
├── roadmap/                  # Long-term strategic planning
└── historical/               # Previous planning cycles

📚 Knowledge Base (knowledge/)

Staging area for claude.ai project knowledge

Files optimized for RAG search in the claude.ai project knowledge base:

knowledge/
├── BRIEFING-CURRENT-STATE.md        → Symlink to docs/briefing/
├── BRIEFING-ESSENTIAL-LEAD-DEV.md   → Symlink to docs/briefing/
├── BRIEFING-ESSENTIAL-ARCHITECT.md  → Symlink to docs/briefing/
├── BRIEFING-ESSENTIAL-AGENT.md      → Symlink to docs/briefing/
├── BRIEFING-ESSENTIAL-*.md          → Symlinks to docs/briefing/
├── CLAUDE.md                        # Agent entry point
├── serena-briefing-queries.md       # Live system state queries
└── README.md                        # Knowledge base workflow guide

See: knowledge/README.md for complete workflow documentation

📦 Archives (archives/)

Historical preservation and archaeological research

Session Logs (archives/session-logs/)

├── 2025/                     # Chronological by year
│   ├── 05/ (May logs)
│   ├── 06/ (June logs)
│   ├── 07/ (July logs)
│   ├── 08/ (August logs)
│   └── 09/ (September logs + index.md)
├── omnibus-logs/             # 102+ weekly/monthly consolidations
└── yearly-index.md           # High-level research navigation

Artifacts & Decisions (archives/)

🎨 Assets (assets/)

Binary files and multimedia content with size management

├── images/                   # Organized by purpose
│   ├── architecture/         # System diagrams
│   ├── screenshots/          # Development captures
│   └── blog/                 # Blog content (186+ files)
├── diagrams/                 # Source and generated
│   ├── source/               # Editable formats
│   └── generated/            # PNG/SVG outputs
└── documents/                # Templates and exports
    ├── templates/            # Document boilerplates
    └── exports/              # Generated documentation

🔍 Finding What You Need

By Work Type

By Time Period

By Content Type

🔧 Documentation Workflow

For Daily Work

  1. Check active status in relevant internal/ directory
  2. Review methodology for process guidance
  3. Create session artifacts in local dev/YYYY/MM/DD/ structure
  4. Process to archives for permanent preservation

For Research & Investigation

  1. Start with yearly index for time-based research
  2. Use monthly indices for detailed period investigation
  3. Cross-reference artifacts with session logs
  4. Follow agent collaboration patterns and handoffs
  5. Check omnibus logs for strategic insights

For New Content Creation

  1. Determine audience (public, internal, or archive)
  2. Follow asset guidelines for binary files
  3. Update navigation as needed for major additions
  4. Maintain cross-references between related content

📊 Restructuring Achievement Summary

Transformation Completed (September 20, 2025)

Key Organizational Improvements

Performance Metrics

🚀 Quick Access Links

Most Frequently Used

For New Team Members

For Research & Analysis

🆘 Help and Support

Contributing to Documentation

Comprehensive navigation system established: September 20, 2025 Supporting role-based access to restructured documentation architecture