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
82 lines
2.6 KiB
Markdown
82 lines
2.6 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
# 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
|