Bifrost/AGENTS.md
2026-04-22 07:35:54 +01:00

2.3 KiB

AGENTS.md

Repo Purpose

  • Bifrost is the GameCult member alpha platform for tasks, governance, contributor accounting, and operational legibility.
  • It sits under the Yggdrasil infrastructure umbrella and should connect GameCult services and workflows without importing crypto ideology or platform theater.

V1 Non-Goals

  • no Ethereum, crypto rails, wallets, or DAO framing
  • no tokenized governance
  • no payout execution from the app
  • no public/open signup community launch
  • no separate SPA frontend in v1

Locked Product Decisions

  • product name: Bifrost
  • v1 audience: invite-only member alpha
  • auth model: GitHub sign-in only
  • membership model: invite + approval gate before active participation
  • task sources: GitHub issues plus internal tasks
  • governance model: app-native motions and voting
  • payout model: internal ledger first, with admin-reviewed payout proposal batches only

Locked Technical Defaults

  • stack: ASP.NET Core 8 LTS
  • UI: Razor Pages + HTMX
  • database: PostgreSQL
  • hosting target: bifrost.gamecult.org on Yggdrasil
  • deployment pattern: nginx + systemd + localhost-only Postgres, matching E:\Projects\gamecult-ops

Naming Defaults

  • app/repo/workspace: Bifrost
  • public hostname: bifrost.gamecult.org
  • infrastructure/server context: Yggdrasil

Ops Assumptions

  • follow the GameCult ops pattern already documented in E:\Projects\gamecult-ops
  • prefer one web app process for v1
  • keep Postgres bound to localhost on the host
  • add deployment runbooks to gamecult-ops when app work begins

Working Notes

  • Read existing docs before reopening settled product decisions.
  • Keep implementation boring where possible; the product idea is ambitious enough already.
  • Push changes after every implementation pass.
  • If a question is about trust, accountability, or payout fairness, prefer auditability over automation.
  • Before debugging UI/layout, inspect the live DOM and computed styles instead of guessing from templates or CSS intent.

Starting Point For The Next Session

Read these files first:

  1. AGENTS.md
  2. README.md
  3. docs/bifrost-mvp-plan.md
  4. docs/full-implementation-strategy.md
  5. docs/context.md

Then start the first implementation milestone:

  • GitHub auth
  • membership gating
  • project and member models
  • work items
  • motions
  • ledgers