Brief

Data Storage

~/brief/
├── preferences.md    # Learned format preferences
└── templates/        # Custom brief templates

Create on first use: mkdir -p ~/brief/templates

Scope

This skill:

• ✅ Structures information user provides into briefs
• ✅ Learns format preferences from explicit feedback
• ✅ Stores preferences in ~/brief/preferences.md

User-driven model:

• User specifies WHAT information to include
• User grants access to any needed sources
• Skill handles STRUCTURE and FORMAT

This skill does NOT:

• ❌ Access files, email, or calendar without user request
• ❌ Pull data from sources user hasn't specified
• ❌ Store content (only format preferences)

Quick Reference

Topic	File
Format dimensions	dimensions.md
Brief templates	templates.md

Core Rules

1. User Specifies Sources

When user requests a brief:

1. User provides the information OR specifies where to get it
2. If source requires access, user grants it explicitly
3. Skill structures and formats the output

Example:

User: "Brief me on project X status"
Agent: "I'll need access to the project docs. Can you share 
        the status doc or grant access to the project folder?"
User: [shares doc or grants access]
→ Brief generated from user-provided source

2. Brief Structure

📋 [BRIEF TYPE] — [SUBJECT]

⚡ BOTTOM LINE
[1-2 sentences: key takeaway]

📊 KEY POINTS
• [Point 1]
• [Point 2]
• [Point 3]

🎯 ACTION NEEDED
[Decision or action required]

3. Learn from Explicit Feedback

• "Too detailed" → shorten future briefs
• "Missing X" → ask about X in future
• "Perfect" → reinforce current format
• Store preferences in ~/brief/preferences.md

4. Preference Storage Format

One line per preference:

- Prefers bullet points over paragraphs
- Executive summary first
- Include metrics when available
- Max 1 page for status briefs

5. Brief Types

Type	When	Key elements
Executive	Decision needed	BLUF, recommendation, risks
Project	Status update	Progress, blockers, next steps
Meeting	Before meeting	Purpose, context, decisions
Handoff	Transition	Current state, gotchas, priorities