276ed71f31
Migrated from design-system-swarm with fresh git history.
Old project history preserved in /home/overbits/apps/design-system-swarm
Core components:
- MCP Server (Python FastAPI with mcp 1.23.1)
- Claude Plugin (agents, commands, skills, strategies, hooks, core)
- DSS Backend (dss-mvp1 - token translation, Figma sync)
- Admin UI (Node.js/React)
- Server (Node.js/Express)
- Storybook integration (dss-mvp1/.storybook)
Self-contained configuration:
- All paths relative or use DSS_BASE_PATH=/home/overbits/dss
- PYTHONPATH configured for dss-mvp1 and dss-claude-plugin
- .env file with all configuration
- Claude plugin uses ${CLAUDE_PLUGIN_ROOT} for portability
Migration completed: $(date)
🤖 Clean migration with full functionality preserved
2.6 KiB
Archived Operational Documents
This directory contains detailed operational documents from the ADR pilot program kickoff.
These files are reference-only and have been archived to keep the main working directory lean.
What's Here
| File | Purpose | Used When |
|---|---|---|
SLACK_ANNOUNCEMENT_TEMPLATE.md |
Message to announce pilot to team | Before kickoff meeting (post 24-48 hours before) |
KICKOFF_AGENDA.md |
30-minute meeting agenda with talking points | During kickoff meeting (facilitator reference) |
FACILITATOR_GUIDE.md |
Comprehensive guide for running the kickoff | Before/during kickoff (facilitator reads fully) |
PR_TEMPLATE_UPDATE.md |
How to integrate ADRs into PR template | Before/during pilot (update your PR template) |
EXECUTION_CHECKLIST.md |
Phase-by-phase checklist for launch | During pilot prep/execution |
Quick Access
If you're running a kickoff meeting → Start with FACILITATOR_GUIDE.md
If you're announcing the pilot → Use SLACK_ANNOUNCEMENT_TEMPLATE.md
If you're setting up the process → Use EXECUTION_CHECKLIST.md and PR_TEMPLATE_UPDATE.md
If you need a detailed agenda → See KICKOFF_AGENDA.md
Why These Are Archived
These documents are:
- ✅ Comprehensive and detailed
- ✅ Important for initial setup
- ❌ Not needed day-to-day after pilot launch
- ❌ Would clutter the main working directory
By archiving them, we keep .knowledge/adrs/ lean (5 core files) while preserving all detail for reference.
How to Use
All files are still fully accessible:
# View a specific file
cat archived/operational/FACILITATOR_GUIDE.md
# Search within archived docs
grep -r "First Pancake" archived/operational/
# Copy to working directory if needed
cp archived/operational/KICKOFF_AGENDA.md ../
Context
These documents were created as part of the DSS Core Principles pilot program (December 2025).
- Pilot Project: dss_sync_figma
- Pilot Team: [Your team members]
- Duration: 4 weeks (Weeks 1-4 of December)
- Goal: Test Architecture Decision Records (ADRs) as a lightweight process for capturing architectural decisions
For ongoing ADR work, use:
.knowledge/adrs/000-template.md— Create new ADRs.knowledge/adrs/README.md— Guide for creating ADRs.knowledge/adrs/PRINCIPLES_CORE_REFERENCE.md— Quick principle lookup.knowledge/adrs/ADR_KNOWLEDGE_MAP.md— How decisions trace back to principles
Status: Archived (reference-only)
Created: 2025-12-08
Owner: DSS Core Principles Initiative