Add docs/, src/, tests/ directories and CONTRIBUTING.md

Agent-Logs-Url: https://github.com/donnyandjoern-debug/personal/sessions/5bec8cf7-24ec-4fdc-9f1c-6bb76465898b Co-authored-by: donnyandjoern-debug <262665187+donnyandjoern-debug@users.noreply.github.com>
Add baseline repository files and complete README
2026-04-16 20:09:47 +00:00 · 2026-04-16 20:06:36 +00:00
18 changed files with 130 additions and 791 deletions
@@ -0,0 +1,12 @@
 # Operating system
 .DS_Store
 Thumbs.db
 # Editors and IDEs
 .idea/
 .vscode/
 *.swp
 *.swo
 # Logs
 *.log
@@ -0,0 +1,36 @@
 # 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
@@ -0,0 +1,21 @@
 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.
@@ -1,63 +1,39 @@
-# 📊 Personal GitHub Operations Command Center
+# Personal Repository (Family Hoppe)
-> Private dashboard for `donnyandjoern-debug` to track GitHub account settings, budget, spending, service usage, and project time.
+This repository is the shared personal space for Family Hoppe projects, notes, and small experiments.
---
+## Purpose
-## Executive Dashboard (Owner Scope Only)
+- Keep family-related project files in one place
 - Track changes over time with Git
 - Provide a clean base for future additions
-| KPI | Current Value | Source |
+## Repository Structure
 |---|---:|---|
 | 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
 ```
-## Repository Scope (Intentionally Limited)
+## Current Status
-This repository tracks only:
+- Repository initialized with baseline project structure
 - Basic documentation in place
 - Standard ignore rules and license added
-1. **GitHub account + settings operations** for the owner account
+## Getting Started
 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
-## Current Personal Tracking Snapshot
+## Notes
-| Tracked Project Group | Open Projects | Monthly Budget Allocation | Time Allocation Tracking |
+See `CONTRIBUTING.md` for branching, commit, and pull-request conventions.
 |---|---:|---:|---|
 | [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
@@ -1,44 +0,0 @@
 # 👥 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)
@@ -1,54 +0,0 @@
 # 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)
@@ -1,53 +0,0 @@
 # 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)
@@ -1,53 +0,0 @@
 # 💰 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)
@@ -1,77 +0,0 @@
 # 📊 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)
@@ -0,0 +1,11 @@
 # 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
@@ -1,25 +0,0 @@
 # 📖 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)
@@ -1,119 +0,0 @@
 # 🤖 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)
@@ -1,146 +0,0 @@
 # 🔀 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)
@@ -1,51 +0,0 @@
 # 📁 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)
@@ -1,55 +0,0 @@
 # 🏢 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)
@@ -1,62 +0,0 @@
 # 🏢 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)
@@ -0,0 +1,13 @@
 # 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, …)
 ```
@@ -0,0 +1,9 @@
 # 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.