Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
 copilot-swe-agent[bot]anddonnyandjoern-debug
|
6d878ba1be |
@@ -1,63 +1,12 @@
|
||||
# 📊 Personal GitHub Operations Command Center
|
||||
# personal
|
||||
|
||||
> Private dashboard for `donnyandjoern-debug` to track GitHub account settings, budget, spending, service usage, and project time.
|
||||
Personal repository for Family Hoppe.
|
||||
|
||||
---
|
||||
## Agents
|
||||
|
||||
## Executive Dashboard (Owner Scope Only)
|
||||
- [x] Account budget tracking agent is completed.
|
||||
|
||||
| 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) |
|
||||
## Budget scope
|
||||
|
||||
---
|
||||
|
||||
## Repository Scope (Intentionally Limited)
|
||||
|
||||
This repository tracks only:
|
||||
|
||||
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
|
||||
|
||||
---
|
||||
|
||||
## Current Personal Tracking Snapshot
|
||||
|
||||
| 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
|
||||
- Budget for this account: **USD 50**
|
||||
- No other account is tracked.
|
||||
|
||||
@@ -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)
|
||||
@@ -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)
|
||||
Reference in New Issue
Block a user