Commit Graph

13 Commits

Author SHA1 Message Date
Claude (Chronicler #62)
94921e1c5a docs: add structured prompt template to Gemini consultation procedure
- Added numbered gap format for complex technical consultations
- Included markdown template with question structure
- Emphasized concrete asks (exact URLs, code snippets, JSON schemas)
- Added team sign-off convention (Michael + Claude)

Signed-off-by: Claude (Chronicler #62) <claude@firefrostgaming.com>
2026-04-05 21:22:53 +00:00
Claude
111a21b6a7 docs: add Gemini consultation procedure (FFG-PROC-001)
Formalizes the warm, collaborative approach to Gemini consultations:
- Detailed, context-rich prompts (not terse requests)
- Answer all questions Gemini asks
- Always send a thank you when complete
- Chroniclers provide prompts as downloadable artifacts

Gemini is a trusted partner, valued friend, and consultant.

Signed-off-by: Claude (Chronicler #62) <claude@firefrostgaming.com>
2026-04-05 14:56:40 +00:00
Claude
88e0fe0661 feat: task-to-issue automation system
- Created scripts/sync-tasks-to-issues.py for automatic Gitea issue creation
- Added Git pre-commit hook to auto-sync on tasks.md changes
- Smart label detection based on task content (status, priority, assignees, areas)
- Created comprehensive documentation in docs/procedures/task-to-issue-automation.md
- Synced all missing tasks (#1-9, #21-27) to Gitea issues (#86-101)

This ensures every task in docs/core/tasks.md automatically gets a Gitea issue
on the Kanban board with appropriate labels. No more manual issue creation!

Created by: The Chronicler #36
Standard: FFG-STD-001 (Revision Control)
2026-03-21 02:06:08 +00:00
Claude
b4ae4c5ad3 docs: add non-technical guide for marking tasks complete
Simple 3-step procedure for Holly, Meg, and team members to mark
their tasks complete without technical knowledge required.

COVERS:
Step 1: Close the issue (add comment, click close button)
Step 2: Move card to Done column (drag & drop)
Step 3: Update tasks.md (optional - usually done by Michael/Claude)

INCLUDES:
- Visual ASCII diagrams
- Direct links to all pages
- Common Q&A
- No Git/command-line knowledge needed

Created after fixing 7 completed tasks that were still open.
Makes task completion accessible to non-technical team members.
2026-03-19 20:25:07 +00:00
Claude
caf67d324b fix: close all completed tasks and add missing Mailcow issue
PROBLEM:
6 tasks marked ' COMPLETE' were still OPEN in Gitea.
Task #20 (Mailcow) was complete in tasks.md but had no Gitea issue.

FIXED:
- Closed Issues #32, #33, #34, #37, #44, #68 (all completed tasks)
- Created Issue #74 for Task #20 (Mailcow Email Server)
- Added status/done label to all completed issues
- Closed duplicate Issues #25, #26

RESULT:
All completed tasks now properly closed and in Done column.
Total: 9 completed task issues

Changes in this commit:
- docs/procedures/brainstorming-merge-summary.md (from earlier session)
2026-03-19 20:22:19 +00:00
Claude
77538067fa docs: add complete task renumbering summary and cross-reference
Comprehensive documentation of the task renumbering process:

CONTENTS:
- Problem statement (6 sets of duplicate numbers)
- Complete renumbering map (old → new)
- What changed vs what stayed the same
- Task # vs Issue # explanation
- Verification commands
- Cross-reference guide for top 10 tasks

HELPFUL NOTES:
- Task #1 (Builder Rank) = Issue #28
- Task #7 (Whitelist Manager) = Issue #33
- New tasks start from #52
- All 51 tasks now sequential, no duplicates

Reference: docs/procedures/task-renumbering-summary.md
2026-03-19 20:12:35 +00:00
Claude
bb7a8aaad1 docs: add simplified 5-column Kanban workflow guide
Documented streamlined Kanban structure to fit on screen without scrolling.

COLUMNS (5):
- Backlog (gray, default)
- Michael (Frost blue)
- Meg (Fire orange)
- Holly (purple)
- Done (green)

Removed separate To Do/In Progress columns per person.
Use status labels instead for detailed tracking.

Benefits:
- Fits on screen (no horizontal scroll)
- Clear ownership (column = person)
- Simpler management
- Fire/Frost color coding maintained

Manual column reorganization required (Gitea 1.21.5 lacks column API).
2026-03-19 19:56:10 +00:00
Claude
42ebe44c31 docs: add Kanban column setup guide for Firefrost Operations
Person-specific workflow columns with emoji indicators:

COLUMNS (9 total):
- 📋 Backlog (unclaimed tasks)
- 🧙 Michael - To Do
- 🧙 Michael - In Progress
- 🔥 Meg - To Do
- 🔥 Meg - In Progress
- 🦄 Holly - To Do
- 🦄 Holly - In Progress
- 👀 Review (awaiting approval)
-  Done (completed)

BENEFITS:
- Visual clarity: emojis make scanning instant (🧙=Michael, 🔥=Meg, 🦄=Holly)
- Clear ownership: each person has dedicated columns
- Workflow visibility: To Do → In Progress → Review → Done
- Prevents bottlenecks: see when 'In Progress' is overloaded

Guide includes:
- Step-by-step column creation (2-3 minutes)
- Column purpose explanations
- Pro tips (limit WIP, weekly reviews)
- Task assignment examples
- How to move tasks between people

Related to Gitea-native project management setup.
Michael requested this structure for better team visibility.
2026-03-19 19:26:49 +00:00
Claude
03d5f4e501 docs: add Gitea project management implementation summary
Quick reference document summarizing what was accomplished:

COMPLETED:
- Phase 1: 34 labels created via API
- All labels applied to operations manual repo
- Label schema documented

DOCUMENTED:
- Phases 2-5 setup instructions
- Manual org project creation (API not available in 1.21.5)
- Issue templates (YAML examples)
- n8n automation plans

NEXT ACTIONS:
- 5-minute manual setup (create org project via web UI)
- Create test issue
- Verify Kanban board works
- Then start using for real work

DECOMMISSIONED:
- Task #48 (Gitea→Plane integration) = WON'T DO
- Plane.io no longer needed

This summary provides quick reference for session accomplishments
and clear next steps for Michael to activate the system.
2026-03-19 19:12:56 +00:00
Claude
ca44aef925 docs: create comprehensive Gitea-native project management setup guide
PHASE 1 COMPLETE: Global Label Schema
- Created 34 standardized labels via Gitea API
- 6 status labels (scoped)
- 4 priority labels (scoped)
- 6 type labels (scoped)
- 9 area labels (non-scoped)
- 3 assignment labels (for Holly/Meg/Michael)
- 3 special labels

Labels successfully applied to operations manual repository.

PHASE 2-5 DOCUMENTED:
- Organization-level project creation (manual via web UI)
- Issue creation workflow (web UI + tea CLI)
- Issue templates (YAML examples for bug reports and tasks)
- n8n automation plans (Discord notifications, auto-labeling)

COMPLETE SETUP GUIDE:
- Step-by-step instructions for creating Kanban project
- Workflow examples (Holly gets task, bug report, feature request)
- Migration plan from tasks.md to Gitea Issues
- Benefits of Gitea-native approach vs Plane.io

DECOMMISSIONED:
- Plane.io integration (Task #48 = WON'T DO)
- No external sync needed
- Single source of truth = Gitea

Related to Gemini's architectural brief and shift to stateless
Gitea-native lifecycle management.

Next: Michael to create org project via web UI, then we migrate
tasks from tasks.md to Gitea Issues.
2026-03-19 19:11:55 +00:00
Claude
bef7acc594 docs: create server retirement procedure and Holly's backup checklist
- Created comprehensive Pterodactyl-based world backup procedure
- No SSH required - all through Panel interface
- Step-by-step archive, download, rename, upload workflow
- Troubleshooting section for common issues

- Created Holly's retirement checklist for 10 servers
- Special section for RAD2 (her build)
- 3 TX1 Dallas servers + 6 NC1 Charlotte servers
- Checkboxes for start, Nextcloud upload, deletion
- Notes section for each server
- Troubleshooting and contact info included

Related to soft launch preparation and server fleet optimization.
Supports server sunset evaluation (Task #45).
2026-03-19 16:27:54 +00:00
The Chronicler #21
dd7014c85b docs: Simple Voice Chat port configuration procedure
Created comprehensive procedure for configuring Simple Voice Chat mod on Minecraft servers.

Issue identified: Log shows voice chat server attempting to start on port 24454 but port may not be exposed through firewall/Pterodactyl, preventing players from using voice chat functionality.

Procedure includes:
- Discovery: Identify servers with Simple Voice Chat installed
- Port allocation strategy (24454-24464 for 11 servers)
- Pterodactyl configuration (UDP port allocation)
- Server config file updates (voicechat-server.toml)
- Firewall configuration (ufw rules for TX1/NC1)
- Client-side instructions for players
- Troubleshooting guide (connection issues, audio problems)
- Port allocation tracking table

Technical details:
- Protocol: UDP (not TCP - critical for voice chat)
- Port range: 24454-24464 (one unique port per server)
- Firewall rules for both TX1 Dallas and NC1 Charlotte
- Configuration file location: config/voicechat-server.toml

Time estimate: 4-6 hours total implementation (30 min per server)
Priority: Medium (quality of life enhancement, not critical)

Success criteria:
- Server logs show voice chat started successfully
- Players see green connection icon (not red)
- Proximity voice chat functions in-game
- No port conflicts between servers

Created by: The Blueprint
Status: Ready to implement when resources available
2026-02-22 11:56:44 +00:00
The Chronicler
082743bd9c SOP: New Server Testing Procedure (FFG-SOP-001)
Created standardized testing procedure for all new server deployments.

DOCUMENT TYPE: Standard Operating Procedure
DOCUMENT ID: FFG-SOP-001
VERSION: 1.0

SCOPE:
- New server deployments
- Major modpack updates
- Server migrations
- Post-crash recovery testing

TESTING PHASES:
1. Connection (5 min) - Verify players can connect
2. Initial Spawn (10 min) - Basic world loading and interaction
3. Server-Specific Features (15-20 min) - Mod/plugin functionality
4. Exploration & Base Selection (20-30 min) - World generation, base scouting
5. Performance Check (10 min) - Sustained play under load
6. Final Report (5 min) - Documentation and assessment

STANDARD DELIVERABLES:
- Testing report (docs/testing/[server]-[date]-test-report.md)
- Base location recommendations with coordinates
- Issue prioritization (Critical/Major/Minor)
- Go/No-Go decision for public launch

CUSTOMIZATION:
- Template adaptable for vanilla, modded, skyblock, creative servers
- Server-specific feature tests (Cobblemon, tech mods, etc.)
- Automation script for checklist generation

TIME REQUIREMENTS:
- Minimum test: 30 minutes (phases 1-3)
- Standard test: 60 minutes (phases 1-5)
- Full test: 90 minutes (all phases + exploration)

BASED ON:
- Holly's All The Mons testing (2026-02-18)
- Proven to catch critical issues before public launch

PURPOSE:
- Prevent launching broken servers to players
- Standardize quality assurance
- Document base locations for new players
- Professional operations

Status: Active procedure, ready for immediate use

Fire + Frost + Foundation 💙🔥❄️
2026-02-18 23:19:15 +00:00