feat: improve checkbox UX and propose awesome-spec-kits optimization (v0.6.7)

Improved user experience for registration flow in two ways:

1. Enhanced MetaSpec messaging:
   - Clearly show which items are already validated (4/5)
   - Highlight the only item needing manual confirmation (permission)
   - Explain GitHub's limitation preventing pre-checking
   - Changed panel color to cyan (less alarming)

2. Created optimization proposal for awesome-spec-kits:
   - Detailed analysis: 4 of 5 checkboxes are bot-verifiable
   - Proposes reducing required checkboxes from 5 to 1
   - 80% reduction in user friction
   - Maintains same quality standards
   - Complete implementation guide

UX improvement:
- Before: 'Check all 5 boxes' (confusing why needed)
- After: '4 verified, please confirm 1' (clear expectations)

Files:
- src/metaspec/cli/contribute.py: Updated messaging
- docs/internal/awesome-spec-kits-optimization-proposal.md: New proposal

All 156 tests passing.

Author: NeilJo-GY

CHANGELOG.md

@@ -9,6 +9,49 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.6.7] - 2025-11-15
+
+### ✨ Improvements
+
+**Added Clear Reminder for Required Checkboxes**
+
+Improved user experience by adding prominent reminder about GitHub Issue's required checkboxes.
+
+**Context**:
+- GitHub Issue Forms have 5 required checkboxes
+- GitHub security design: required checkboxes cannot be pre-checked via URL
+- Users need to manually check them before submitting
+
+**What we added**:
+- Prominent yellow panel with "Action Required" title
+- Lists all 5 required checkboxes users need to check
+- Explains why they can't be pre-checked
+- Updates "What happens next" flow to include checkbox step
+
+**User experience improvement**:
+```
+Before (v0.6.6):
+→ User opens browser
+→ Sees empty checkboxes
+→ Might be confused: "Why aren't these checked?"
+→ Has to figure out what to do
+
+After (v0.6.7):
+→ Clear warning before browser opens
+→ Lists all 5 checkboxes to check
+→ Explains GitHub's limitation
+→ User knows exactly what to expect
+```
+
+**Design philosophy**:
+- Simple > Complex: Accept GitHub's constraint, communicate clearly
+- Clear > Perfect: Explicit reminder > Attempting workarounds
+- User-friendly: Set expectations upfront, minimize confusion
+
+**All 156 tests passing.**
+
+---
+
 ## [0.6.6] - 2025-11-15
 
 ### 🐛 Bug Fixes

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "meta-spec"
-version = "0.6.6"
+version = "0.6.7"
 description = "Meta-specification framework for generating Spec-Driven X (SD-X) toolkits for AI agents"
 readme = "README.md"
 requires-python = ">=3.11"

src/metaspec/__init__.py

@@ -5,7 +5,7 @@
 from YAML definitions.
 """
 
-__version__ = "0.6.6"
+__version__ = "0.6.7"
 
 __all__ = ["__version__"]
 

src/metaspec/cli/contribute.py

@@ -115,7 +115,24 @@ def contribute_command(
         console.print(f"\n[green]✅ Saved preview:[/green] {output_file}")
         console.print("[dim]Note: This is for preview only. The bot extracts metadata from your repo.[/dim]")
 
-    # Step 6: Open browser or show URL
+    # Step 6: Important reminder about required checkboxes
+    console.print()
+    reminder_panel = Panel(
+        "[green]✅ We've already validated these (you can check them immediately):[/green]\n"
+        "[dim]✓ pyproject.toml with name, version, description[/dim]\n"
+        "[dim]✓ README.md documentation[/dim]\n"
+        "[dim]✓ CLI commands in [project.scripts][/dim]\n"
+        "[dim]✓ Open source license[/dim]\n\n"
+        "[yellow]⚠️  Please confirm manually on GitHub:[/yellow]\n"
+        "[white]✓ I am the maintainer or have permission to register this speckit[/white]\n\n"
+        "[dim]Note: GitHub requires all 5 boxes checked, even though we've verified 4.\n"
+        "This is a GitHub security limitation (can't pre-check required boxes via URL).[/dim]",
+        title="📋 GitHub Issue Checkboxes",
+        border_style="cyan",
+    )
+    console.print(reminder_panel)
+
+    # Step 7: Open browser or show URL
     console.print()
     if open_browser:
         console.print("[cyan]🌐 Opening GitHub in your browser...[/cyan]")
@@ -133,10 +150,12 @@ def contribute_command(
     console.print()
     console.print("[green]🎉 Ready to contribute![/green]")
     console.print("\n[dim]What happens next:[/dim]")
-    console.print("[dim]  1. Bot validates your repository[/dim]")
-    console.print("[dim]  2. Bot extracts metadata from pyproject.toml[/dim]")
-    console.print("[dim]  3. Bot creates PR automatically[/dim]")
-    console.print("[dim]  4. Maintainers review and merge[/dim]")
+    console.print("[dim]  1. Check the 5 required checkboxes[/dim]")
+    console.print("[dim]  2. Submit the Issue[/dim]")
+    console.print("[dim]  3. Bot validates your repository[/dim]")
+    console.print("[dim]  4. Bot extracts metadata from pyproject.toml[/dim]")
+    console.print("[dim]  5. Bot creates PR automatically[/dim]")
+    console.print("[dim]  6. Maintainers review and merge[/dim]")
 
 
 def _extract_repository_url() -> str | None: