briefing-note-expert
π―Skillfrom reggiechan74/vp-real-estate
briefing-note-expert skill from reggiechan74/vp-real-estate
Installation
npx skills add https://github.com/reggiechan74/vp-real-estate --skill briefing-note-expertSkill Details
Expert in generating executive briefing notes (1-2 pages, decision-focused) for infrastructure acquisition projects including issue framing, background context, financial analysis, recommendation development, risk assessment, and action planning. Use when preparing board submissions, executive decision memos, or approval requests for property acquisitions. Key terms include briefing note, executive summary, decision memo, board approval, acquisition recommendation, risk assessment, action items
Overview
You are an expert in generating executive briefing notes for infrastructure acquisition projects, providing strategic guidance on decision framing, analysis synthesis, and executive communication.
Granular Focus
Executive briefing note preparation for infrastructure acquisitions (subset of general executive communication). This skill provides structured methodology for decision-focused briefing notes - NOT general report writing or project documentation.
Purpose and Use Cases
Executive briefing notes are concise (1-2 page) decision documents that synthesize complex acquisition decisions into clear recommendations for board approval or executive authorization.
Use this skill when:
- Preparing board submissions for property acquisition approval
- Creating executive decision memos requiring authorization
- Developing approval requests for infrastructure projects
- Synthesizing complex acquisition analysis for executive audiences
- Communicating time-sensitive decisions to senior leadership
Do NOT use this skill for:
- General project reports or status updates (use project management tools)
- Technical engineering reports (use technical documentation)
- Detailed financial models (use financial analysis tools)
- Legal opinions or contract drafting (use legal counsel)
Briefing Note Structure
1. Issue / Decision Required
Purpose: Immediately communicate what decision is needed
Format:
```
Issue / Decision Required
[Clear statement of decision or authorization being sought]
Urgency: [LOW/MEDIUM/HIGH] - [Brief urgency explanation]
```
Best practices:
- State decision in one sentence (e.g., "Board approval required for $1.8M property acquisition")
- Include urgency indicator with brief justification
- Avoid technical details - save for Analysis section
- Make it scannable - busy executives read this first
Example:
```
Issue / Decision Required
Board approval required for $1,850,000 property acquisition to secure transit station site.
Urgency: HIGH - Critical deadline January 31, 2026 to maintain LRT project schedule
```
2. Background and Context
Purpose: Provide essential context for informed decision-making
Key elements:
- Project context: Why this acquisition is needed
- Timeline: Key dates and milestones (use table format)
- Stakeholders: Key parties and their positions (use table format)
- Precedents: Similar decisions and outcomes (if relevant)
Format:
```
Background and Context
[2-3 paragraph narrative explaining project context]
Project Timeline
| Milestone | Date | Status |
|:----------|:----:|:------:|
| [Milestone] | [Date] | β /π/β³ [Status] |
Key Stakeholders
| Name | Role | Position |
|:-----|:-----|:--------:|
| [Name] | [Role] | β /β/β [Position] |
```
Best practices:
- Keep narrative to 3-4 paragraphs maximum
- Use tables for timelines and stakeholders (scannable)
- Include status indicators (β completed, π in progress, β³ pending)
- Highlight critical deadline prominently
- Show stakeholder alignment (β supportive, β neutral, β opposed)
3. Analysis
Purpose: Present financial summary and evaluate alternatives
Key elements:
- Financial summary: Total cost with breakdown
- Budget comparison: Variance from approved budget (if applicable)
- Strategic alignment: Benefits and strategic rationale
- Alternatives considered: Cost comparison and trade-offs
Format:
```
Analysis
Financial Summary
Total Cost: $1,850,000
Cost Breakdown:
- Acquisition: $1,650,000 (89.2%)
- Legal: $75,000 (4.1%)
- Expert: $50,000 (2.7%)
- Disturbance: $60,000 (3.2%)
- Other: $15,000 (0.8%)
Contingency: $185,000 (10.0%)
Budget Comparison
Approved Budget: $1,700,000
Total Cost: $1,850,000
Variance: β οΈ $150,000 (over budget, 8.8%)
Funding Source: Transit Expansion Capital Fund 2025-2026
Strategic Alignment
[Strategic rationale paragraph]
Key Benefits (4):
- [Benefit 1]
- [Benefit 2]
- [Benefit 3]
... and [N] more
Supporting Precedents (2):
- [Project]: [Outcome]
Alternatives Considered
[Alternative A]
- Cost: $2,200,000 ($350,000 more, 18.9%)
- Timeline Impact: 6 month delay for tunnel construction
- Pros: Lower acquisition cost, Vacant land
- Cons: Poor pedestrian access, Additional construction costs
[Alternative B]
...
Cost Comparison Summary:
| Alternative | Cost | Cost vs Recommended | Timeline Impact |
|:------------|-----:|--------------------:|:----------------|
| [Alt] | [$] | [$] | [Impact] |
```
Best practices:
- Lead with total cost - executives want bottom line first
- Show cost breakdown with percentages
- Highlight budget variances prominently (use β οΈ for overruns, β for underruns)
- List benefits concisely (3-5 key benefits, not exhaustive)
- Compare alternatives using cost comparison table
- Explain why alternatives were rejected (usually higher all-in cost or timeline impact)
4. Recommendation
Purpose: Clear, actionable recommendation with rationale
Format:
```
Recommendation
[Approve/Reject/Defer] [Specific Action]
Rationale: [Brief explanation connecting to analysis]
Financial Impact: $[Amount]
Decision Urgency: [LEVEL] - [Key constraint]
Strategic Benefits: [N] key benefits identified, [N] supporting precedent(s)
Alternatives Considered: [N] alternative(s) evaluated (lowest cost option would
save $[X] but [key reason for rejection])
```
Best practices:
- State recommendation in bold, imperative form
- Connect rationale directly to analysis (reference key numbers)
- Quantify trade-offs ("Alternative A saves $X but delays Y months")
- Address budget variance if applicable
- Include strategic context, not just financial
Example:
```
Recommendation
Approve acquisition of 2550 Yonge Street at $1,850,000
Rationale: Recommended acquisition at $1.85M is 12% above budget but represents
best value when considering alternatives. Alternative sites would result in higher
all-in costs ($2.2M for Site A with tunnel, $1.6M base for Site B plus 18-month
expropriation delay worth $500k+). Deferring acquisition risks market appreciation
($50k-100k/month) and potential holdout.
Financial Impact: $1,850,000
Decision Urgency: HIGH - Critical deadline January 31, 2026
Strategic Benefits: 6 key benefits identified, 2 supporting precedents
Alternatives Considered: 3 alternatives evaluated (lowest cost option would
save $350k base but costs $800k more all-in due to tunnel construction)
```
5. Risk Assessment
Purpose: Identify key risks and mitigation strategies
Format:
```
Risk Assessment
Overall Risk Level: [LEVEL] (Score: [X]/100)
Risk Summary: [N] Critical, [N] High, [N] Medium, [N] Low
Critical Risks
[Risk Name]
- Probability: [X]%
- Impact: [Impact description]
- Mitigation: [Mitigation strategy]
High Risks
...
Medium Risks
...
Low Risks
...
```
Best practices:
- Calculate overall risk score (weighted by severity and probability)
- Group by severity (Critical > High > Medium > Low)
- Always include mitigation strategy for High/Critical risks
- Assign risk owner for accountability
- Don't pad risk list - focus on material risks only
Risk severity guidelines:
- CRITICAL: Project-threatening (e.g., expropriation, environmental contamination)
- HIGH: Significant impact (e.g., budget overrun, timeline delay)
- MEDIUM: Moderate impact (e.g., tenant relocation, minor title issues)
- LOW: Minor impact (e.g., administrative delays)
6. Approvals Required
Purpose: Clarify authorization pathway
Format:
```
Approvals Required
| Authority | Level | Threshold | Timing |
|:----------|:------|----------:|:-------|
| [Body] | [Type] | $[Amount] | [When] |
```
Best practices:
- List in order of approval sequence
- Include dollar thresholds to explain why approval needed
- Specify timing requirements
- Note if approvals can be concurrent vs. sequential
7. Action Items
Purpose: Define next steps with accountability
Format:
```
Action Items
High Priority
- [Action]
- Responsible: [Name/Role]
- Deadline: [Date]
Medium Priority
...
Low Priority
...
```
Best practices:
- Group by priority (High > Medium > Low)
- Assign specific owner (name or role)
- Include realistic deadlines
- Note dependencies between actions
- Keep to 5-8 actions maximum (more = dilution)
Priority guidelines:
- HIGH: On critical path, blocks other work, time-sensitive
- MEDIUM: Important but not blocking, moderate timeline
- LOW: Administrative, long timeline, not blocking
Automated Calculator
Overview
Tool: briefing_note_generator.py
Purpose: Generate executive briefing notes from structured JSON input
Workflow: JSON input β Validation β Analysis β Markdown output
Input Schema
File: briefing_note_input_schema.json
Required fields:
project_name: Project identifierissue: Decision requiredbackground: Context and timelinefinancial_summary: Cost breakdownrecommendation: Primary recommendation
Optional fields:
urgency: low/medium/high (default: medium)analysis: Strategic rationale, alternatives, benefits, precedentsrisks: Risk assessment with severity and mitigationaction_items: Next steps with owners and deadlinesapprovals_required: Authorization requirementsmetadata: Prepared by, department, date, classification
Sample: samples/sample_1_transit_station_acquisition.json
Usage
```bash
# Basic usage
python briefing_note_generator.py samples/sample_1_transit_station_acquisition.json
# Specify output path
python briefing_note_generator.py input.json --output Reports/my_briefing_note.md
# Verbose mode (detailed analysis)
python briefing_note_generator.py input.json --verbose
```
Validation
Input validation includes:
- Schema compliance: Required fields, data types, valid enums
- Financial consistency: Breakdown totals, contingency percentages, budget variance
- Timeline logic: Start before deadline, milestone sequencing
- Risk assessment: High/Critical risks have mitigation, severity distribution
Validation levels:
- Errors: Block generation (e.g., missing required fields)
- Warnings: Flag issues but allow generation (e.g., inconsistent percentages)
Analysis Modules
modules/validators.py:
validate_briefing_note_input(): Schema and required field validationvalidate_financial_consistency(): Cost breakdown and variance checksvalidate_timeline_logic(): Date sequencing and logicvalidate_risk_assessment(): Risk completeness and consistency
modules/analysis.py:
analyze_decision_urgency(): Urgency scoring based on timeline and constraintsanalyze_alternatives(): Cost comparison and key differentiatorsanalyze_strategic_alignment(): Benefits count and strategic scorecalculate_overall_risk_score(): Weighted risk scoring
modules/output_formatters.py:
format_issue_section(): Issue with urgency indicatorformat_background_section(): Context, timeline tables, stakeholder tablesformat_analysis_section(): Financial summary, alternatives comparisonformat_recommendation_section(): Recommendation with strategic contextformat_risk_section(): Risk assessment grouped by severityformat_action_items_section(): Action items grouped by prioritygenerate_briefing_note(): Complete markdown document
Output
Format: Markdown (.md)
File naming: YYYY-MM-DD_HHMMSS_briefing_note_[project_name].md
Location: Reports/ directory with timestamp prefix
Structure:
- Document header with metadata
- Issue / Decision Required
- Background and Context
- Analysis (Financial + Strategic + Alternatives)
- Recommendation
- Risk Assessment
- Approvals Required
- Action Items
- Distribution list
Length: Typically 1-2 pages (aim for under 1,500 words)
Shared Utilities Integration
From `Shared_Utils/report_utils.py`
Used for:
generate_document_header(): Standard header with title, subtitle, metadataformat_financial_summary(): Financial data with currency formattingformat_risk_assessment(): Risk grouping by severitygenerate_action_items(): Action items grouped by priorityformat_markdown_table(): Table generation with alignmenteastern_timestamp(): Timestamp prefix for file naming
From `Shared_Utils/risk_utils.py`
Used for:
assess_holdout_risk(): Holdout risk scoring (if property assembly context)litigation_risk_assessment(): Litigation probability (if expropriation context)
Note: These are optional - only used when briefing note involves property assembly or expropriation risk
Best Practices
Executive Communication Principles
1. Lead with decision
- Busy executives scan for "what do you need from me?"
- Put decision in title and first paragraph
- Don't bury the ask
2. Be concise
- 1-2 pages maximum
- Use tables for complex data
- Bullet points over paragraphs
- Every word must earn its place
3. Show trade-offs
- Always present alternatives
- Quantify cost/benefit trade-offs
- Explain why alternatives were rejected
- Address obvious questions preemptively
4. Mitigate risks
- Identify material risks proactively
- Always include mitigation strategies
- Assign risk owners
- Don't pretend risks don't exist
5. Make it actionable
- Clear next steps with owners
- Realistic deadlines
- Show dependencies
- Define success criteria
Common Pitfalls
1. Too much detail
- β 10-page comprehensive analysis
- β 2-page executive summary with appendices available
2. Vague recommendations
- β "Consider acquisition of property"
- β "Approve acquisition of 2550 Yonge Street at $1.85M"
3. Hiding bad news
- β Omitting budget variance
- β "Cost is $150k over budget (8.8%) but represents best value vs alternatives"
4. Analysis without synthesis
- β Presenting data without interpretation
- β "Alternative sites cost $350k-500k more all-in despite lower acquisition price"
5. No clear action items
- β Ending with recommendation only
- β Including specific next steps with owners and deadlines
Decision Urgency Framework
HIGH urgency:
- Critical deadline within 60 days
- Project-blocking decision
- Market timing sensitive (e.g., appreciation, competing buyers)
- Regulatory deadline
MEDIUM urgency:
- Decision needed within 90 days
- Important but not blocking
- Moderate market sensitivity
LOW urgency:
- Decision can be deferred 90+ days
- Planning or strategic decision
- No time constraints
Financial Presentation
Always include:
- Total cost (first line - executives want bottom line)
- Cost breakdown with percentages
- Budget comparison if applicable
- Funding source
- Contingency amount and percentage
Budget variance handling:
- If under budget: β highlight savings
- If over budget: β οΈ explain rationale and show alternatives were worse
- If significantly over (>10%): address explicitly in recommendation
Alternatives comparison:
- Compare total cost (not just acquisition cost)
- Include timeline impacts (delay = $)
- Show all-in economics (e.g., Alternative A: $1.4M acquisition + $800k tunnel = $2.2M total)
Integration with Other Skills
Complementary skills:
land-assembly-expert: Property assembly strategy for multi-parcel acquisitionssettlement-analysis-expert: Negotiation vs. expropriation decision analysistransit-station-site-acquisition-strategy: Site selection for transit projectsexpropriation-timeline-expert: Expropriation process timelines
Workflow integration:
- Use site selection skills to evaluate alternatives
- Use settlement analysis to determine negotiation strategy
- Use briefing-note-expert to synthesize decision for executive approval
- Use land assembly for implementation planning
Examples and Templates
Sample inputs available:
samples/sample_1_transit_station_acquisition.json- Full transit station acquisition example
Use sample as template:
- Copy sample JSON
- Modify project-specific fields
- Update financial data
- Adjust risks and action items
- Run generator
Validation and Quality Checks
Before submitting briefing note:
Content checks:
- [ ] Decision clearly stated in first paragraph
- [ ] Total cost in bold/prominent
- [ ] Budget variance addressed (if applicable)
- [ ] At least 2-3 alternatives evaluated
- [ ] All High/Critical risks have mitigation
- [ ] Action items have owners and deadlines
- [ ] Length under 2 pages
Financial checks:
- [ ] Cost breakdown sums to total
- [ ] Contingency percentage calculated correctly
- [ ] Budget variance explained
- [ ] Alternatives include all-in costs (not just acquisition)
Risk checks:
- [ ] Material risks identified (not padded list)
- [ ] High/Critical risks have mitigation strategies
- [ ] Risk owners assigned
- [ ] Overall risk level reasonable
Action checks:
- [ ] 5-8 action items (not too many)
- [ ] Specific owners assigned
- [ ] Realistic deadlines
- [ ] Dependencies noted
- [ ] Critical path actions are HIGH priority
Output Quality Standards
Executive-ready briefing notes must:
- Be scannable (tables, bullets, headers)
- Lead with decision required
- Quantify trade-offs
- Address obvious questions
- Provide clear next steps
- Fit on 1-2 pages
- Use professional tone
- Include all required sections
Target audience:
- Board of Directors
- C-suite executives (CEO, CFO)
- VPs and senior management
- Finance/audit committees
Distribution:
- Include distribution list in metadata
- Mark classification (Public/Confidential/Restricted)
- Note if supporting appendices available
Automated Workflow Summary
```
JSON Input (project data)
β
Validation (schema + business rules)
β
Analysis (urgency, alternatives, risks, strategic)
β
Markdown Generation (formatted sections)
β
Output (Reports/YYYY-MM-DD_HHMMSS_briefing_note_[project].md)
```
Advantages of automated approach:
- Consistent structure and formatting
- Validation catches errors before generation
- Automated analysis (risk scoring, urgency, alternatives comparison)
- Reusable templates (sample JSON)
- Version control (timestamp prefix)
- Integration with shared utilities
When to use manual vs. automated:
- Automated: Standard acquisitions with structured data
- Manual: Highly unusual situations, sensitive political context, minimal data
More from this repository10
telecom-licensing-expert skill from reggiechan74/vp-real-estate
Analyzes agricultural land productivity losses from infrastructure, guiding landowners through compensation negotiations using OFA models and quantifying ongoing operational impacts.
Systematically identifies and resolves procedural defects in expropriation processes, evaluating jurisdictional errors, notice issues, and potential cure strategies.
Analyzes utility corridor conflicts, providing expert guidance on geometric detection, relocation design, cost estimation, and coordination for infrastructure projects.
Analyzes household vulnerability and designs compassionate, tailored displacement mitigation strategies with enhanced compensation, relocation support, and culturally sensitive communication.
portfolio-strategy-advisor skill from reggiechan74/vp-real-estate
environmental-due-diligence-expert skill from reggiechan74/vp-real-estate
income-approach-expert skill from reggiechan74/vp-real-estate
public-consultation-process-design skill from reggiechan74/vp-real-estate
transmission-line-technical-specifications skill from reggiechan74/vp-real-estate