{"id":50370129,"url":"https://github.com/binaryphile/finances","last_synced_at":"2026-05-30T06:31:06.879Z","repository":{"id":360097241,"uuid":"1248579470","full_name":"binaryphile/finances","owner":"binaryphile","description":"Household financial practice — Cockburn use cases, technique, tooling. No financial data in repo (see README privacy rule).","archived":false,"fork":false,"pushed_at":"2026-05-25T00:53:10.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-25T02:29:27.600Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/binaryphile.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-24T20:33:57.000Z","updated_at":"2026-05-25T00:53:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/binaryphile/finances","commit_stats":null,"previous_names":["binaryphile/finances"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/binaryphile/finances","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryphile%2Ffinances","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryphile%2Ffinances/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryphile%2Ffinances/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryphile%2Ffinances/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/binaryphile","download_url":"https://codeload.github.com/binaryphile/finances/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/binaryphile%2Ffinances/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33682998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-30T02:00:06.278Z","response_time":92,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-30T06:31:05.269Z","updated_at":"2026-05-30T06:31:06.870Z","avatar_url":"https://github.com/binaryphile.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# finances\n\nSoftware, technique, and Cockburn use cases for running a household financial\npractice. This is a methodology repo, not a data repo.\n\n## Privacy rule (hard requirement)\n\n**This repo is public. No real financial data ever lands in it.**\n\nThat means: no account numbers, no balances, no transaction amounts, no\ninstitution names tied to real accounts, no income figures, no debt totals,\nno transaction exports. Examples in use cases and docs use placeholders:\n\n- Institutions: `Acme Bank`, `Beta Brokerage`, `Pet-Insurer-X`\n- Account identifiers: `Account-A`, `Account-B`\n- Amounts: `$X`, `$N`, `$M` — never a real digit\n- People: `Primary`, `Spouse`, `Child` — when an actor's identity is not the\n  point of the example\n\nPersonal data lives elsewhere (outside the repo, never committed). Conventional\nlocal-only paths (`private/`, `data/`, `personal/`, `scratch/`) are\n`.gitignore`d as a backstop; the primary defense is the rule above.\n\nDefense in depth:\n\n1. The rule above, restated in `CLAUDE.md` so every Claude session honors it.\n2. `.gitignore` blocks common financial file types (`*.csv`, `*.xlsx`,\n   `*.ofx`, `*.pdf`, etc.) and the local-only directories listed above.\n3. `.githooks/pre-commit` scans staged content for currency-with-magnitude\n   patterns and long digit runs (account / routing numbers). Override with\n   `SKIP_FINANCE_SCAN=1` for documented false positives.\n\nActivate the pre-commit hook in any new clone:\n\n    git config core.hooksPath .githooks\n\n## Purpose\n\nTreat household financial life as a system under design. Use Cockburn use\ncases to identify actors, stakeholders, goals, and the scenarios that satisfy\neach goal. The portfolio of use cases is the source of truth for *what* the\nhousehold needs from its financial practice; `docs/design.md` describes\n*how* the practice is mechanized (v1: spreadsheet + CLI tools).\n\nSee `docs/use-cases.md` for the use-case portfolio and the current\nstate of the work (Status section), and `docs/design.md` for the\nmechanism layer.\n\n## Layout\n\n    docs/use-cases.md     # Cockburn use-case portfolio (the canonical WHAT; entry point)\n    docs/design.md        # mechanism / HOW layer pairing with use-cases.md\n    bin/                  # nix-wrapper symlinks (gitignored, populated by update-env)\n    .githooks/pre-commit  # privacy firewall scanner\n    flake.nix             # devShell\n\n## Conventions\n\nThe repo follows Tandem Protocol conventions (see `CLAUDE.md`) for any\nsubstantive change cycle. For methodology drafting (use-case writing) the\nceremony is typically light — most edits are documentation-only.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinaryphile%2Ffinances","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbinaryphile%2Ffinances","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbinaryphile%2Ffinances/lists"}