docs: refocus personal dashboard to owner-only spending and project-time tracking

Agent-Logs-Url: https://github.com/donnyandjoern-debug/personal/sessions/4caa93f1-50a1-4120-8f5e-79b31823d2e5

Co-authored-by: donnyandjoern-debug <262665187+donnyandjoern-debug@users.noreply.github.com>

.gitignore

@@ -1,12 +0,0 @@
-# Operating system
-.DS_Store
-Thumbs.db
-
-# Editors and IDEs
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# Logs
-*.log

CONTRIBUTING.md

@@ -1,36 +0,0 @@
-# Contributing
-
-Thank you for contributing to the Family Hoppe personal repository! Please follow these guidelines to keep things tidy.
-
-## Branching
-
-- Work on a dedicated branch, never directly on `main`.
-- Use descriptive branch names, e.g. `feature/add-recipe-tracker` or `fix/typo-in-docs`.
-
-## Commits
-
-- Write short, meaningful commit messages in the imperative mood.  
-  ✅ `Add holiday photo script`  
-  ❌ `added stuff`
-- Keep commits focused – one logical change per commit.
-
-## Pull Requests
-
-1. Fork / branch off `main`.
-2. Make your changes and add or update tests where relevant.
-3. Ensure all tests pass before opening the PR.
-4. Fill in the PR description with a brief summary of what changed and why.
-5. Request a review from at least one other family member.
-
-## Code Style
-
-- Prefer clear, readable code over clever one-liners.
-- Add comments when the *why* is not obvious from the code itself.
-- Follow the conventions of whichever language you are using.
-
-## Reporting Issues
-
-Open a GitHub Issue with:
-- A clear title
-- Steps to reproduce (if applicable)
-- Expected vs. actual behaviour

LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Family Hoppe
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

README.md

@@ -1,39 +1,63 @@
-# Personal Repository (Family Hoppe)
+# 📊 Personal GitHub Operations Command Center
 
-This repository is the shared personal space for Family Hoppe projects, notes, and small experiments.
+> Private dashboard for `donnyandjoern-debug` to track GitHub account settings, budget, spending, service usage, and project time.
 
-## Purpose
+---
 
-- Keep family-related project files in one place
+## Executive Dashboard (Owner Scope Only)
-- Track changes over time with Git
-- Provide a clean base for future additions
 
-## Repository Structure
+| KPI | Current Value | Source |
+|---|---:|---|
+| Active Account in Scope | 1 (`donnyandjoern-debug`) | [Accounts](./accounts/README.md) |
+| Monthly Budget Baseline | $35 planned baseline | [Budget Dashboard](./budget/README.md) |
+| Tracked Services | Copilot, Actions, Packages, Codespaces, reserve | [Budget Dashboard](./budget/README.md) |
+| Tracked Projects | 2 tracked project groups (owner-managed) | [Projects Dashboard](./projects/README.md) |
+| Time Tracking | Enabled by project/repository and month | [Tracking Ledger](./budget/tracking.md) |
+| Privacy & Access | Private repo, owner-only by default | [Accounts](./accounts/README.md) |
 
-```
+---
-personal/
-├── docs/          # Guides, notes, and decision records
-├── src/           # Source code and scripts
-├── tests/         # Tests for code in src/
-├── CONTRIBUTING.md
-├── LICENSE
-└── README.md
-```
 
-## Current Status
+## Repository Scope (Intentionally Limited)
 
-- Repository initialized with baseline project structure
+This repository tracks only:
-- Basic documentation in place
-- Standard ignore rules and license added
 
-## Getting Started
+1. **GitHub account + settings operations** for the owner account
+2. **Budget and spending** (including spending over time)
+3. **Usage by service** (Copilot, Actions, Packages, Codespaces, reserve)
+4. **Project allocation + time tracking** by project/repository and month
 
-1. Clone the repository
+---
-2. Browse `docs/` for guidance or add documentation there
-3. Place source code under `src/` and matching tests under `tests/`
-4. Commit your changes with clear messages
-5. See [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request
 
-## Notes
+## Current Personal Tracking Snapshot
 
-See `CONTRIBUTING.md` for branching, commit, and pull-request conventions.
+| Tracked Project Group | Open Projects | Monthly Budget Allocation | Time Allocation Tracking |
+|---|---:|---:|---|
+| [Hoppe-home](./projects/hoppe-home.md) | 0 (to update) | $0 (to allocate) | ✅ |
+| [Hoppe-GitHub](./projects/hoppe-github.md) | 0 (to update) | $0 (to allocate) | ✅ |
+| **Total** | **0** | **$0 allocated** | **✅** |
+
+> Update project allocations in [projects/README.md](./projects/README.md) and month-by-month spending/time in [budget/tracking.md](./budget/tracking.md).
+
+---
+
+## Quick Navigation
+
+| Section | Purpose |
+|---|---|
+| [👥 Accounts](./accounts/README.md) | Owner account details, settings, and privacy/access model |
+| [💰 Budget](./budget/README.md) | Service-category budget baseline, actuals, and variance |
+| [📈 Tracking Ledger](./budget/tracking.md) | Monthly spending over time, by service, by project, and time spent |
+| [🗂 Projects](./projects/README.md) | Tracked projects with budget/time rollups |
+| [📖 Guides](./guides/README.md) | Workflow and operating notes |
+
+---
+
+## Recommended Additional Areas to Track (Within Scope)
+
+- Monthly billing events and invoice notes
+- Subscription/renewal dates (Copilot or other paid GitHub services)
+- Actions/Codespaces/Packages usage observations by month
+- Copilot seat/plan status checks
+- Monthly review checklist for budget and project variance
+- Key GitHub settings/security reminders (2FA, recovery methods, trusted devices)
+- Org/repo ownership map and project priority review cadence

accounts/README.md

@@ -0,0 +1,44 @@
+# 👥 GitHub Accounts (Owner-Only Tracking Scope)
+
+This private repository tracks account operations for `donnyandjoern-debug` first.
+
+---
+
+## Active Tracking Scope
+
+| Account | Purpose | Details |
+|---|---|---|
+| [donnyandjoern-debug](./family-hoppe.md) | Primary tracked owner account for this dashboard | [→ Details](./family-hoppe.md) |
+
+---
+
+## Optional Future Context (Not in Active Tracking Scope)
+
+| Account | Status | Details |
+|---|---|---|
+| [Joern reference account](./joern-hoppe.md) | Optional / future reference only | Not currently included in active spending tracking |
+
+---
+
+## Privacy and Access Intent
+
+This repository is private and intended for owner use only:
+
+- Default audience: `donnyandjoern-debug`
+- Stores personal GitHub settings, budget, spending, and project/time tracking notes
+- Not intended as a general family/shared financial repository
+- Access should be shared only when explicitly needed
+
+---
+
+## General GitHub Settings to Track
+
+- Billing plan and monthly paid-service baseline
+- Copilot status (plan, seat, renewal timing)
+- 2FA/security posture (2FA enabled, recovery methods validated)
+- Primary organization memberships and access level
+- Primary devices/editors used for GitHub operations
+
+---
+
+[← Back to main library](../README.md)

accounts/family-hoppe.md

@@ -0,0 +1,54 @@
+# donnyandjoern-debug — Primary Owner Account
+
+## Identity
+
+| Field | Value |
+|---|---|
+| GitHub username | `donnyandjoern-debug` |
+| Role | Repository owner and primary tracked account |
+| Primary device | Mac |
+| Primary editor | VS Code (Mac) |
+| Organisation | [Hoppe-home](https://github.com/Hoppe-home) |
+
+---
+
+## Plans, Budget Baseline, and Tracking Scope
+
+| Item | Cost | Status | Notes |
+|---|---:|---|---|
+| GitHub base plan | $0 / month | ✅ Active | Base account plan |
+| Copilot Pro | $10 / month | ✅ Active | Known recurring personal cost |
+| GitHub usage budget reserve | $25 / month | ✅ Active baseline | Tracked by service category in [budget/README.md](../budget/README.md) |
+| **Total monthly baseline** | **$35 / month** |  | |
+
+---
+
+## Repository Tracking Intent
+
+| Repo | Description |
+|---|---|
+| [personal](https://github.com/donnyandjoern-debug/personal) | Private owner dashboard for account/settings, spending, budget, and project-time tracking |
+
+> This repository is private and owner-focused; sharing access is optional and explicit.
+
+---
+
+## General GitHub Settings to Keep Current
+
+- Billing profile and payment method status
+- Copilot plan/seat status and renewal timing
+- 2FA and recovery options verification
+- Primary org memberships and role changes
+- Primary devices/editors used for operational updates
+
+---
+
+## Notes
+
+- Use [budget/tracking.md](../budget/tracking.md) as the single monthly ledger for spending over time.
+- Keep service-level and project-level allocations aligned with [projects/README.md](../projects/README.md).
+- Optional secondary-account references should remain out of active spending scope unless explicitly enabled.
+
+---
+
+[← Back to accounts](./README.md) | [← Back to main library](../README.md)

accounts/joern-hoppe.md

@@ -0,0 +1,53 @@
+# Joern Account Reference — Optional Future Context
+
+> Not currently in active tracking scope for this private owner dashboard.
+
+## Reference Identity (Future Use)
+
+| Field | Value |
+|---|---|
+| GitHub username | _(to be decided — must use alphanumeric characters and hyphens only, e.g. `joern-hoppe`)_ |
+| Role | Optional secondary workspace account (future) |
+| Primary device | Windows PC |
+| Primary editor | VS Code (Windows) |
+| Organisation | [Hoppe-home](https://github.com/Hoppe-home) |
+
+---
+
+## Memberships & Plans
+
+| Plan | Cost | Status | Notes |
+|---|---|---|---|
+| GitHub Free (base) | $0 / month | Active | Unlimited public repos |
+| **Copilot Pro** | **$10 / month** | 🟡 Planned | Include in budget only if activated later |
+| **Total** | **$10 / month** | Planned | |
+
+---
+
+## Scope Note
+
+This page is reference-only.
+Do not treat this account as active for spending or time tracking unless the owner explicitly decides to add it.
+
+---
+
+## If Activated Later
+
+- [ ] Create the GitHub account for `Joern@Hoppe.home`
+- [ ] Activate Copilot Pro ($10/month)
+- [ ] Add account to the Hoppe-home organisation
+- [ ] Configure VS Code on Windows with GitHub Copilot extension
+- [ ] Sign in to VS Code with the Joern account
+- [ ] Test Copilot completion and chat in VS Code (Windows)
+- [ ] Connect to Hoppe-home projects and verify access
+
+---
+
+## Notes
+
+- Keep this account separate from the primary owner-only dashboard scope.
+- If activated, mark the exact start month before adding any budget entries.
+
+---
+
+[← Back to accounts](./README.md) | [← Back to main library](../README.md)

budget/README.md

@@ -0,0 +1,53 @@
+# 💰 Personal Budget Dashboard
+
+Service-category budget control for `donnyandjoern-debug` GitHub operations.
+
+---
+
+## Monthly Budget Baseline by Service
+
+| Service Category | Monthly Budget | Current Actual (Month) | Variance | Notes |
+|---|---:|---:|---:|---|
+| GitHub Copilot | $10 | $10 | $0 | Copilot Pro active |
+| GitHub Actions | $5 | $0 | -$5 | Estimate — update from billing |
+| GitHub Packages | $3 | $0 | -$3 | Estimate — update from billing |
+| GitHub Codespaces | $7 | $0 | -$7 | Estimate — update from billing |
+| Other paid GitHub features / reserve | $10 | $0 | -$10 | Flexible reserve |
+| **Total** | **$35** | **$10** | **-$25** | Baseline aligned to owner-only scope |
+
+---
+
+## Spending Over Time
+
+Use the ledger for month-by-month updates:
+
+- [Monthly spend summary](./tracking.md#a-monthly-spend-summary-by-month)
+- [Monthly spend by service](./tracking.md#b-monthly-spend-by-service-category)
+- [Project/repository allocation and actuals](./tracking.md#c-monthly-projectrepository-budget-allocation-and-actuals)
+- [Time by project/repository over time](./tracking.md#d-time-tracking-by-projectrepository-over-time)
+
+---
+
+## Project Allocation Snapshot
+
+| Tracked Project Group | Monthly Allocation | Current Actual | Variance |
+|---|---:|---:|---:|
+| Hoppe-home | $0 | $0 | $0 |
+| Hoppe-GitHub | $0 | $0 | $0 |
+| **Total** | **$0** | **$0** | **$0** |
+
+> Update project-level amounts in [tracking.md](./tracking.md) and [projects/README.md](../projects/README.md).
+
+---
+
+## Budget Operating Rules
+
+1. Keep one owner-only monthly baseline.
+2. Track spending by service category and month.
+3. Allocate budget and actual spending by project/repository.
+4. Record monthly time spent by project/repository.
+5. Mark unknown amounts as estimates until confirmed from billing.
+
+---
+
+[← Back to main library](../README.md)

budget/tracking.md

@@ -0,0 +1,77 @@
+# 📊 Spending + Time Tracking Ledger
+
+Central owner-only ledger for monthly spending over time and project/repository time allocation.
+
+> Update monthly during the first week of each new month.
+> Label unknown values as estimates until verified from GitHub billing.
+
+---
+
+## A) Monthly Spend Summary by Month
+
+| Month | Total Spend (Actual) | Monthly Budget Baseline | Variance | Data Quality | Notes |
+|---|---:|---:|---:|---|---|
+| April 2026 | $10 | $35 | -$25 | Partial actual + estimates | Copilot actual known; other services pending billing |
+| May 2026 | $10 *(to update from billing)* | $35 | -$25 *(est.)* | Estimate | Carry baseline until month-end reconciliation |
+
+---
+
+## B) Monthly Spend by Service Category
+
+| Month | Service Category | Budget | Actual Spend | Variance | Notes |
+|---|---|---:|---:|---:|---|
+| April 2026 | GitHub Copilot | $10 | $10 | $0 | Copilot Pro active |
+| April 2026 | GitHub Actions | $5 | $0 | -$5 | Estimate — update from billing |
+| April 2026 | GitHub Packages | $3 | $0 | -$3 | Estimate — update from billing |
+| April 2026 | GitHub Codespaces | $7 | $0 | -$7 | Estimate — update from billing |
+| April 2026 | Other paid features / reserve | $10 | $0 | -$10 | Reserve |
+| May 2026 | GitHub Copilot | $10 | $10 *(expected)* | $0 *(est.)* | Update when invoice posts |
+| May 2026 | GitHub Actions | $5 | $0 *(est.)* | -$5 *(est.)* | Update from billing |
+| May 2026 | GitHub Packages | $3 | $0 *(est.)* | -$3 *(est.)* | Update from billing |
+| May 2026 | GitHub Codespaces | $7 | $0 *(est.)* | -$7 *(est.)* | Update from billing |
+| May 2026 | Other paid features / reserve | $10 | $0 *(est.)* | -$10 *(est.)* | Reserve |
+
+---
+
+## C) Monthly Project/Repository Budget Allocation and Actuals
+
+| Month | Project Group | Project | Repository | Budget Allocated | Actual Spend | Variance | Notes |
+|---|---|---|---|---:|---:|---:|---|
+| April 2026 | Hoppe-home | _(add project)_ | `Hoppe-home/repo-name` | $0 | $0 | $0 | Add once active |
+| April 2026 | Hoppe-GitHub | _(add project)_ | `Hoppe-GitHub/repo-name` | $0 | $0 | $0 | Add once active |
+| May 2026 | Hoppe-home | _(add project)_ | `Hoppe-home/repo-name` | $0 | $0 *(est.)* | $0 *(est.)* | To update |
+| May 2026 | Hoppe-GitHub | _(add project)_ | `Hoppe-GitHub/repo-name` | $0 | $0 *(est.)* | $0 *(est.)* | To update |
+
+---
+
+## D) Time Tracking by Project/Repository Over Time
+
+| Month | Date | Source | Project Group | Project | Repository | Activity Type | Hours | Session Ref | Notes |
+|---|---|---|---|---|---|---|---:|---|---|
+| April 2026 | 2026-04-20 | VS Code | Hoppe-home | _(add project)_ | `Hoppe-home/repo-name` | Coding / Planning / Debugging | 0.0 | Link or short ID | |
+| April 2026 | 2026-04-20 | Online Chat | Hoppe-GitHub | _(add project)_ | `Hoppe-GitHub/repo-name` | Coding / Planning / Debugging | 0.0 | Link or short ID | |
+| May 2026 | YYYY-MM-DD | VS Code / Online Chat | Hoppe-home / Hoppe-GitHub | _(add project)_ | `org/repo` | Coding / Planning / Debugging | 0.0 | Link or short ID | Add real sessions monthly |
+
+---
+
+## E) Monthly Time Rollup (Hours by Project/Repository)
+
+| Month | Project Group | Project | Repository | Coding Hours | Planning Hours | Debugging Hours | Total Hours |
+|---|---|---|---|---:|---:|---:|---:|
+| April 2026 | Hoppe-home | _(add project)_ | `Hoppe-home/repo-name` | 0.0 | 0.0 | 0.0 | 0.0 |
+| April 2026 | Hoppe-GitHub | _(add project)_ | `Hoppe-GitHub/repo-name` | 0.0 | 0.0 | 0.0 | 0.0 |
+| May 2026 | Hoppe-home / Hoppe-GitHub | _(add project)_ | `org/repo` | 0.0 | 0.0 | 0.0 | 0.0 |
+
+---
+
+## F) Monthly Review Checklist
+
+- [ ] Confirm Copilot charge and reconcile actual spend
+- [ ] Pull Actions/Codespaces/Packages billing values and update service table
+- [ ] Reconcile project/repository spend actuals vs budget allocations
+- [ ] Roll up time spent by project/repository
+- [ ] Capture billing events, renewals, and settings/security reminders for next month
+
+---
+
+[← Back to budget dashboard](./README.md) | [← Back to main library](../README.md)

docs/README.md

@@ -1,11 +0,0 @@
-# Documentation
-
-This directory contains documentation for Family Hoppe projects.
-
-## Structure
-
-Add topic-specific markdown files here as projects grow, for example:
-
-- `how-to-*.md` – guides and how-tos
-- `decisions/` – architecture / decision records
-- `notes/` – free-form notes and ideas

guides/README.md

@@ -0,0 +1,25 @@
+# 📖 Guides — Family Hoppe
+
+Quick-reference guides for GitHub, Copilot, and the Family Hoppe workflow.
+
+---
+
+## Available Guides
+
+| Guide | Description |
+|---|---|
+| [GitHub Copilot](./copilot.md) | Copilot tips, shortcuts, and multi-account workflow |
+| [GitHub Workflow](./github-workflow.md) | Branching, PRs, issues, and clean repo practices |
+
+---
+
+## Principles for Family Hoppe
+
+1. **Clean** — No clutter. Archive or delete repos that are no longer needed.
+2. **Professional** — Meaningful commit messages, good READMEs, proper branching.
+3. **Precise** — Do the right thing the first time. Use Copilot to help but always review.
+4. **Consistent** — Same workflow on Mac (donnyandjoern-debug) and Windows (Joern@Hoppe.home).
+
+---
+
+[← Back to main library](../README.md)

guides/copilot.md

@@ -0,0 +1,119 @@
+# 🤖 GitHub Copilot Guide — Family Hoppe
+
+Quick reference for getting the most out of GitHub Copilot across both Family Hoppe accounts.
+
+---
+
+## Accounts & Plans
+
+| Account | Plan | Editor | Status |
+|---|---|---|---|
+| donnyandjoern-debug | Copilot Pro ($10/mo) | VS Code (Mac) | ✅ Active |
+| Joern _(account pending creation)_ | Copilot Pro ($10/mo) | VS Code (Windows) | 🟡 Planned |
+
+---
+
+## Copilot Features (Pro Plan)
+
+| Feature | Description | Where |
+|---|---|---|
+| **Code completion** | Inline AI suggestions as you type | VS Code editor |
+| **Copilot Chat** | Ask questions about code, get explanations | VS Code sidebar / inline |
+| **Copilot Edits** | Multi-file AI edits for larger changes | VS Code |
+| **Copilot Coding Agent** | Autonomous agent that solves GitHub issues | GitHub.com (browser) |
+| **PR summaries** | Auto-generated pull request descriptions | GitHub.com |
+| **Copilot CLI** | AI-powered terminal suggestions | Terminal / shell |
+| **GitHub Models** | Access to AI models via the API | GitHub Marketplace |
+
+---
+
+## VS Code Setup
+
+### Install Copilot in VS Code
+
+1. Open VS Code
+2. Go to Extensions (`Ctrl+Shift+X` / `Cmd+Shift+X`)
+3. Search for **"GitHub Copilot"** and install it
+4. Also install **"GitHub Copilot Chat"**
+5. Sign in with your GitHub account when prompted
+
+### Key Shortcuts (VS Code)
+
+| Action | Mac | Windows |
+|---|---|---|
+| Accept suggestion | `Tab` | `Tab` |
+| Dismiss suggestion | `Esc` | `Esc` |
+| Next suggestion | `Alt+]` | `Alt+]` |
+| Previous suggestion | `Alt+[` | `Alt+[` |
+| Open Copilot Chat | `Ctrl+Cmd+I` | `Ctrl+Alt+I` |
+| Inline chat | `Cmd+I` | `Ctrl+I` |
+| Open Copilot Edits | `Ctrl+Shift+I` | `Ctrl+Shift+I` |
+
+---
+
+## Copilot Coding Agent (Cloud Agent)
+
+The Copilot Coding Agent lets Copilot autonomously work on GitHub issues:
+
+1. Go to a GitHub Issue in your browser
+2. Click **"Assign to Copilot"** (or mention `@github-copilot` in a comment)
+3. Copilot opens a PR with the solution
+4. Review the PR, request changes if needed, and merge
+
+**Tips:**
+- Write clear, detailed issue descriptions — the agent works from the issue text.
+- The agent works best on well-scoped, single-concern issues.
+- Always review the agent's PR before merging.
+
+---
+
+## Multi-Account Workflow
+
+When working across both accounts (Mac + Windows):
+
+1. Each account has its own Copilot Pro subscription — they work independently.
+2. Both accounts can collaborate on the same Hoppe-home organisation repos.
+3. Copilot suggestions are personal — they do not sync between accounts.
+4. Use GitHub Issues and PRs to hand off work between accounts.
+
+---
+
+## Useful Copilot Chat Prompts
+
+```
+# Explain code
+/explain
+
+# Fix a bug
+/fix
+
+# Generate tests
+/tests
+
+# Create documentation
+/doc
+
+# Simplify code
+Simplify this function and reduce duplication
+
+# Review a PR
+Review this pull request for security issues and code quality
+
+# Clean up a repo
+What files in this repo are redundant or should be removed?
+```
+
+---
+
+## Best Practices
+
+- ✅ Always review Copilot suggestions before accepting
+- ✅ Use Copilot Chat to understand unfamiliar code
+- ✅ Use the Coding Agent for well-defined GitHub issues
+- ✅ Write good commit messages — Copilot can help with these too
+- ❌ Don't accept suggestions blindly — Copilot can hallucinate
+- ❌ Don't use Copilot to generate secrets, passwords, or credentials
+
+---
+
+[← Back to guides](./README.md) | [← Back to main library](../README.md)

guides/github-workflow.md

@@ -0,0 +1,146 @@
+# 🔀 GitHub Workflow Guide — Family Hoppe
+
+Best practices for clean, professional GitHub work across all Family Hoppe projects.
+
+---
+
+## Branch Strategy
+
+Use a simple **feature-branch workflow**:
+
+```
+main           ← stable, always deployable
+└── feature/short-description   ← your working branch
+└── fix/issue-description       ← bug fix branch
+└── docs/update-readme          ← documentation update
+```
+
+**Rules:**
+- Never commit directly to `main`
+- Branch names: lowercase, hyphens only, descriptive (e.g., `feature/add-user-login`)
+- Delete branches after merging
+
+---
+
+## Commit Messages
+
+Follow the **Conventional Commits** format:
+
+```
+<type>: <short description>
+
+[optional body]
+[optional footer]
+```
+
+| Type | When to use |
+|---|---|
+| `feat:` | A new feature |
+| `fix:` | A bug fix |
+| `docs:` | Documentation changes only |
+| `chore:` | Maintenance (deps, config, cleanup) |
+| `refactor:` | Code restructuring without feature/fix |
+| `test:` | Adding or updating tests |
+
+**Examples:**
+```
+feat: add user authentication
+fix: correct off-by-one error in pagination
+docs: update README with installation steps
+chore: update dependencies to latest versions
+```
+
+---
+
+## Pull Request Checklist
+
+Before opening a PR:
+- [ ] Branch is up to date with `main`
+- [ ] All tests pass
+- [ ] Code has been reviewed (or Copilot Chat used to review)
+- [ ] PR description explains what and why
+- [ ] No secrets or credentials in the diff
+
+---
+
+## Issue Best Practices
+
+Write issues that Copilot (and humans) can act on:
+
+1. **Title:** Short and specific (e.g., "Add dark mode toggle to settings page")
+2. **Description:** What should happen vs. what currently happens
+3. **Acceptance criteria:** Bullet list of what "done" looks like
+4. **Labels:** Use labels (`bug`, `feature`, `docs`, `chore`)
+5. **Assignee:** Assign to yourself or to Copilot
+
+**Good issue template:**
+```markdown
+## What
+A clear description of the change needed.
+
+## Why
+Why is this needed? What problem does it solve?
+
+## Acceptance Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Additional Context
+Any links, screenshots, or related issues.
+```
+
+---
+
+## Repo Hygiene
+
+Keep repos clean and professional:
+
+| Practice | Description |
+|---|---|
+| **README.md** | Every repo needs one — what is it, how to run it |
+| **LICENSE** | Add a license (MIT for open source) |
+| **.gitignore** | Always add a proper `.gitignore` |
+| **Branch protection** | Protect `main` — require PR reviews |
+| **Archive old repos** | Don't delete — archive when no longer active |
+| **Descriptive names** | `hoppe-home/recipe-manager`, not `test123` |
+
+---
+
+## GitHub Search Shortcuts
+
+| Shortcut | Action |
+|---|---|
+| `t` | Search files in the current repo |
+| `/` | Focus global search |
+| `g c` | Go to Code tab |
+| `g i` | Go to Issues tab |
+| `g p` | Go to Pull Requests tab |
+| `?` | Show all keyboard shortcuts |
+
+---
+
+## Useful GitHub CLI Commands
+
+```bash
+# Create a new branch and PR
+gh pr create --title "feat: my feature" --body "Description here"
+
+# View open PRs
+gh pr list
+
+# Check out a PR locally
+gh pr checkout <number>
+
+# View open issues
+gh issue list
+
+# Create an issue
+gh issue create --title "bug: something is broken" --label "bug"
+
+# View repo status
+gh repo view
+```
+
+---
+
+[← Back to guides](./README.md) | [← Back to main library](../README.md)

projects/README.md

@@ -0,0 +1,51 @@
+# 📁 Tracked Projects Dashboard
+
+Owner-focused dashboard for tracked projects, budget allocation, and time-by-repository rollups.
+
+---
+
+## Tracked Project Groups
+
+| Project Group | Owner | Open Projects | Monthly Budget Allocation | Time Tracking | Detail |
+|---|---|---:|---:|---|---|
+| Hoppe-home | donnyandjoern-debug | 0 | $0 | ✅ Tracked | [View](./hoppe-home.md) |
+| Hoppe-GitHub | donnyandjoern-debug | 0 | $0 | ✅ Tracked | [View](./hoppe-github.md) |
+| **Total** |  | **0** | **$0** | **✅** |  |
+
+---
+
+## Open Projects
+
+| Project | Project Group | Repository | Status | Monthly Budget | Actual Spend (Month) | Hours (Month) | Notes |
+|---|---|---|---|---:|---:|---:|---|
+| _(add project)_ | Hoppe-home / Hoppe-GitHub | `org/repo` | 🟢 On Track / 🟡 At Risk / 🔴 Blocked | $0 | $0 | 0h | |
+
+---
+
+## Pipeline Views (Optional)
+
+### Planned
+
+| Project | Portfolio | Repository | Target Start | Priority |
+|---|---|---|---|---|
+| _(add planned project)_ | Hoppe-home / Hoppe-GitHub | `org/repo` | YYYY-MM-DD | High / Medium / Low |
+
+### Completed
+
+| Project | Portfolio | Repository | Completion Date | Outcome |
+|---|---|---|---|---|
+| _(add completed project)_ | Hoppe-home / Hoppe-GitHub | `org/repo` | YYYY-MM-DD | Delivered |
+
+---
+
+## Reporting Standard
+
+1. Track each active project with clear status and repository.
+2. Keep monthly budget allocation and actual spending per project/repo.
+3. Keep monthly time spent by project/repo in [budget/tracking.md](../budget/tracking.md).
+4. Reconcile totals between project pages and the budget ledger each month.
+5. Keep this dashboard private and owner-focused.
+
+---
+
+[← Back to main library](../README.md)

projects/hoppe-github.md

@@ -0,0 +1,55 @@
+# 🏢 Hoppe-GitHub Tracked Projects Dashboard
+
+Owner-managed project tracking for repositories under Hoppe-GitHub.
+
+---
+
+## Project Group Summary
+
+| Field | Value |
+|---|---|
+| Project Group | Hoppe-GitHub |
+| Owner | `donnyandjoern-debug` |
+| Primary Purpose | Track project delivery with budget/spending and time transparency |
+| Reporting Scope | Project status, budget allocation, actual spending, and time by repository |
+
+---
+
+## Privacy and Scope
+
+- This private page is part of the owner-only dashboard.
+- Track only projects and spending/time data relevant to `donnyandjoern-debug`.
+- Do not use this page as a shared family ledger.
+
+---
+
+## Open Projects
+
+| Project | Repository | Status | Monthly Budget | Actual Spend (Month) | Hours (Month) | Owner |
+|---|---|---|---:|---:|---:|---|
+| _(add project)_ | `Hoppe-GitHub/repo-name` | 🟢 On Track / 🟡 At Risk / 🔴 Blocked | $0 | $0 | 0h | |
+
+---
+
+## Budget + Spending Rollup
+
+| Category | Amount | Notes |
+|---|---:|---|
+| Assigned Monthly Budget | $0 | Set at monthly planning review |
+| Forecasted Spend | $0 | Sum of active project estimates |
+| Actual Spend | $0 | Tracked in [budget/tracking.md](../budget/tracking.md) |
+| Variance | $0 | Budget - Actual |
+
+---
+
+## Time Rollup (Copilot Sessions)
+
+| Repository | Coding Hours | Chat Hours | Total Hours | Source |
+|---|---:|---:|---:|---|
+| `Hoppe-GitHub/repo-name` | 0.0 | 0.0 | 0.0 | VS Code + Online Chat |
+
+> Keep monthly entries aligned with the central ledger in [budget/tracking.md](../budget/tracking.md).
+
+---
+
+[← Back to projects dashboard](./README.md) | [← Back to main library](../README.md)

projects/hoppe-home.md

@@ -0,0 +1,62 @@
+# 🏢 Hoppe-home Tracked Projects Dashboard
+
+Owner-managed project tracking for repositories under Hoppe-home.
+
+---
+
+## Project Group Summary
+
+| Field | Value |
+|---|---|
+| Project Group | Hoppe-home |
+| GitHub URL | [https://github.com/Hoppe-home](https://github.com/Hoppe-home) |
+| Owner | `donnyandjoern-debug` |
+| Reporting Scope | Project status, budget allocation, actual spending, and time by repository |
+
+---
+
+## Privacy and Scope
+
+- This private page is part of the owner-only dashboard.
+- Track only projects and spending/time data relevant to `donnyandjoern-debug`.
+- Do not use this page as a shared family ledger.
+
+---
+
+## Open Projects
+
+| Project | Repository | Status | Monthly Budget | Actual Spend (Month) | Hours (Month) | Owner |
+|---|---|---|---:|---:|---:|---|
+| _(add project)_ | `Hoppe-home/repo-name` | 🟢 On Track / 🟡 At Risk / 🔴 Blocked | $0 | $0 | 0h | |
+
+---
+
+## Budget + Spending Rollup
+
+| Category | Amount | Notes |
+|---|---:|---|
+| Assigned Monthly Budget | $0 | Set at monthly planning review |
+| Forecasted Spend | $0 | Sum of active project estimates |
+| Actual Spend | $0 | Tracked in [budget/tracking.md](../budget/tracking.md) |
+| Variance | $0 | Budget - Actual |
+
+---
+
+## Time Rollup (Copilot Sessions)
+
+| Repository | Coding Hours | Chat Hours | Total Hours | Source |
+|---|---:|---:|---:|---|
+| `Hoppe-home/repo-name` | 0.0 | 0.0 | 0.0 | VS Code + Online Chat |
+
+---
+
+## Portfolio Governance Checklist
+
+- [ ] Keep open projects table current
+- [ ] Review budget variance monthly
+- [ ] Ensure all active repos have owners and status
+- [ ] Align spending and hour totals with [budget/tracking.md](../budget/tracking.md)
+
+---
+
+[← Back to projects dashboard](./README.md) | [← Back to main library](../README.md)

src/README.md

@@ -1,13 +0,0 @@
-# Source
-
-This directory is the home for source code and scripts belonging to Family Hoppe projects.
-
-## Structure
-
-Organise code by project or language, for example:
-
-```
-src/
-  project-name/
-    main.py  (or index.js, main.go, …)
-```

tests/README.md

@@ -1,9 +0,0 @@
-# Tests
-
-This directory contains tests for the code living in `src/`.
-
-## Conventions
-
-- Mirror the `src/` folder structure so each source file has a corresponding test file.
-- Name test files with a `test_` prefix (Python) or `.test.js` / `_test.go` suffix depending on the language used.
-- Run all tests before opening a pull request.