From ec9bf5feb2aadaa71ef9020d96795ac89beeea10 Mon Sep 17 00:00:00 2001 From: Sam Catlow Date: Thu, 29 Oct 2026 23:22:35 +1100 Subject: [PATCH] docs: track work in Gitea issues instead of beads Every one of the 1709 tracker issues was created in Gitea and checked field by field against its source record: title, body, state, label set, assignee, comments, dependency edges and epic label. All 1729 beads are closed, citing the issue that carries each one, and .beads is removed. Three differences are deliberate: Gitea truncates titles at 253 characters, so three long titles keep their full text in the issue body; Gitea refuses a mutual dependency, so five symmetric relates-to links exist in one direction; issue 497 carries its fix from e3b1103f. --- .beads/.gitignore | 89 ------------------- .beads/README.md | 85 ------------------ .beads/config.yaml | 82 ----------------- .beads/hooks/post-checkout | 33 ------- .beads/hooks/post-merge | 33 ------- .beads/hooks/pre-commit | 33 ------- .beads/hooks/pre-push | 33 ------- .beads/hooks/prepare-commit-msg | 33 ------- .beads/metadata.json | 8 -- .dockerignore | 2 - .gitignore | 5 -- CLAUDE.md | 29 ++++-- docs/prds/external-agent-harness.md | 2 +- .../organisation-automation/00-start-here.md | 18 ++-- .../01-execution-identities.md | 2 +- .../04-navigation-and-setup.md | 2 +- prompts/organisation-automation/GUIDELINES.md | 14 +-- tools/cloud-setup.sh | 4 - ui/AGENTS.md | 6 +- 19 files changed, 42 insertions(+), 471 deletions(-) delete mode 100644 .beads/.gitignore delete mode 100644 .beads/README.md delete mode 100644 .beads/config.yaml delete mode 100755 .beads/hooks/post-checkout delete mode 100755 .beads/hooks/post-merge delete mode 100755 .beads/hooks/pre-commit delete mode 100755 .beads/hooks/pre-push delete mode 100755 .beads/hooks/prepare-commit-msg delete mode 100644 .beads/metadata.json diff --git a/.beads/.gitignore b/.beads/.gitignore deleted file mode 100644 index e5059c1f9..000000000 --- a/.beads/.gitignore +++ /dev/null @@ -1,89 +0,0 @@ -# Dolt database (managed by Dolt, not git) -dolt/ -embeddeddolt/ -proxieddb/ - -# Runtime files -bd.sock -bd.sock.startlock -sync-state.json -last-touched -.exclusive-lock - -# Daemon runtime (lock, log, pid) -daemon.* - -# Push state (runtime, per-machine) -push-state.json - -# Lock files (various runtime locks) -*.lock - -# Credential key (encryption key for federation peer auth — never commit) -.beads-credential-key - -# Local version tracking (prevents upgrade notification spam after git ops) -.local_version - -proxied_server_client_info.json - -# Worktree redirect file (contains relative path to main repo's .beads/) -# Must not be committed as paths would be wrong in other clones -redirect - -# Sync state (local-only, per-machine) -# These files are machine-specific and should not be shared across clones -.sync.lock - -# Workspace operation gate (internal/workspacegate): physical-root gate -# files live beside the guarded root inside .beads (e.g. dolt.gate.lock) -*.gate.lock* -export-state/ -export-state.json -last_pull - -# Ephemeral store (SQLite - wisps/molecules, intentionally not versioned) -ephemeral.sqlite3 -ephemeral.sqlite3-journal -ephemeral.sqlite3-wal -ephemeral.sqlite3-shm - -# Dolt server management (auto-started by bd) -dolt-server.pid -dolt-server.log -dolt-server.lock -dolt-server.port -dolt-server.activity - -# Debug-mode pprof artifacts (written when dolt.debug: true in config.yaml) -dolt-pprof/ - -# Corrupt backup directories (created by bd doctor --fix recovery) -*.corrupt.backup/ - -# issues.jsonl is deliberately TRACKED (see export.git-add in config.yaml). -# Dolt remains the authoritative store and GitHub the external issue surface; -# the tracked export exists so issue state is readable and recoverable from a -# plain git clone, without a Dolt server. Removing it from this file is what -# tracks it -- do NOT add a "!issues.jsonl" negation, which would override the -# fork protection in .git/info/exclude (see the note at the end of this file). -# -# Backups stay local: they are point-in-time copies of the same data. -backup/ - -# Per-project environment file (Dolt connection config, GH#2520) -.env - -# Legacy files (from pre-Dolt versions) -*.db -*.db?* -*.db-journal -*.db-wal -*.db-shm -db.sqlite -bd.db -# NOTE: Do NOT add negation patterns here. -# They would override fork protection in .git/info/exclude. -# Config files (metadata.json, config.yaml) are tracked by git by default -# since no pattern above ignores them. -# config.yaml diff --git a/.beads/README.md b/.beads/README.md deleted file mode 100644 index f0a48183e..000000000 --- a/.beads/README.md +++ /dev/null @@ -1,85 +0,0 @@ -# Beads - AI-Native Issue Tracking - -Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code. - -## What is Beads? - -Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git. - -**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads) - -## Quick Start - -### Essential Commands - -```bash -# Create new issues -bd create "Add user authentication" - -# View all issues -bd list - -# View issue details -bd show - -# Update issue status -bd update --claim -bd update --status done - -# Sync with Dolt remote -bd dolt push -``` - -### Working with Issues - -Issues in Beads are: - -- **Git-native**: Stored in Dolt database with version control and branching -- **AI-friendly**: CLI-first design works perfectly with AI coding agents -- **Branch-aware**: Issues can follow your branch workflow -- **Sync-ready**: Uses Dolt remotes for backup and team sharing - -## Why Beads? - -✨ **AI-Native Design** - -- Built specifically for AI-assisted development workflows -- CLI-first interface works seamlessly with AI coding agents -- No context switching to web UIs - -🚀 **Developer Focused** - -- Issues live in your repo, right next to your code -- Works offline, syncs when you push -- Fast, lightweight, and stays out of your way - -🔧 **Git Integration** - -- Dolt-native sync via bd dolt push / bd dolt pull -- Branch-aware issue tracking -- Dolt-native three-way merge resolution - -## Get Started with Beads - -Try Beads in your own projects: - -```bash -# Install Beads -curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash - -# Initialize in your repo -bd init - -# Create your first issue -bd create "Try out Beads" -``` - -## Learn More - -- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs) -- **Quick Start Guide**: Run `bd quickstart` -- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples) - ---- - -_Beads: Issue tracking that moves at the speed of thought_ ⚡ diff --git a/.beads/config.yaml b/.beads/config.yaml deleted file mode 100644 index e5aa099ce..000000000 --- a/.beads/config.yaml +++ /dev/null @@ -1,82 +0,0 @@ -# Beads Configuration File -# This file configures default behavior for all bd commands in this repository -# All settings can also be set via environment variables (BD_* prefix) -# or overridden with command-line flags - -# Issue prefix for this repository (used by bd init) -# If not set, bd init will auto-detect from directory name -# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc. -# issue-prefix: "" - -# Use no-db mode: JSONL-only, no Dolt database -# When true, .beads/issues.jsonl is the only local store -# no-db: false - -# Enable JSON output by default -# json: false - -# Feedback title formatting for mutating commands (create/update/close/dep/edit) -# 0 = hide titles, N > 0 = truncate to N characters -# output: -# title-length: 255 - -# Default actor for audit trails (overridden by BEADS_ACTOR or --actor) -# actor: "" - -# Optional JSONL sidecar for explicit agent/tool interaction audit records. -# Issue history is always recorded in the database and is visible with -# bd history --events; this only controls .beads/interactions.jsonl. -# audit: -# enabled: false - -# Export events (audit trail) to .beads/events.jsonl on each flush/sync -# When enabled, new events are appended incrementally using a high-water mark. -# Use 'bd export --events' to trigger manually regardless of this setting. -# events-export: false - -# Multi-repo configuration (experimental - bd-307) -# Allows hydrating from multiple repositories and routing writes to the correct database -# repos: -# primary: "." # Primary repo (where this database lives) -# additional: # Additional repos to hydrate from (read-only) -# - ~/beads-planning # Personal planning repo -# - ~/work-planning # Work planning repo - -# Dolt-native backup (periodic backup for off-machine recovery) -# This is full database backup only. Cross-machine sync uses Dolt remotes. -# backup: -# enabled: false # Disable auto-backup entirely -# interval: 15m # Minimum time between auto-backups -# git-push: false # Disable git push (backup locally only) -# git-repo: "" # Separate git repo for backups (default: project repo) - -# Optional JSONL auto-export for viewers, interchange, and issue-level migration. -# Disabled by default; enable only when an integration needs fresh .beads/issues.jsonl. -# Use relative paths under .beads/ for JSONL import/export filenames. -export: - auto: false - path: issues.jsonl - interval: 60s - # issues.jsonl/interactions.jsonl are .gitignore'd local-only files -- - # Dolt (synced via sync.remote) is the source of truth. Leave auto off - # and git-add off; do not re-track these in git. - git-add: false -import: - path: issues.jsonl -# Integration settings (access with 'bd config get/set') -# Non-secret keys (stored in the database): -# - jira.url, jira.project -# - linear.team_id -# - github.org, github.repo -# -# Secret keys (stored in this file but prefer env vars to avoid git exposure): -# - linear.api_key → use LINEAR_API_KEY env var instead -# - github.token → use GITHUB_TOKEN env var instead -sync.remote: "git+https://github.com/samcharles93/archie-core.git" -dolt: - shared-server: false - auto-commit: "on" -audit: - enabled: true -agent: - profile: team-maintainer diff --git a/.beads/hooks/post-checkout b/.beads/hooks/post-checkout deleted file mode 100755 index c56039649..000000000 --- a/.beads/hooks/post-checkout +++ /dev/null @@ -1,33 +0,0 @@ -#!/usr/bin/env sh -# --- BEGIN BEADS INTEGRATION v1.2.2 --- -# This section is managed by beads. Do not remove these markers. -if command -v bd >/dev/null 2>&1; then - export BD_GIT_HOOK=1 - _bd_timeout=${BEADS_HOOK_TIMEOUT:-300} - _bd_used_perl=0 - if command -v timeout >/dev/null 2>&1; then - timeout "$_bd_timeout" bd hooks run post-checkout "$@" - _bd_exit=$? - elif command -v gtimeout >/dev/null 2>&1; then - gtimeout "$_bd_timeout" bd hooks run post-checkout "$@" - _bd_exit=$? - elif command -v perl >/dev/null 2>&1; then - _bd_used_perl=1 - perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run post-checkout "$@" - _bd_exit=$? - else - echo >&2 "beads: hook 'post-checkout' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT" - bd hooks run post-checkout "$@" - _bd_exit=$? - fi - if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then - echo >&2 "beads: hook 'post-checkout' timed out after ${_bd_timeout}s — continuing without beads" - _bd_exit=0 - fi - if [ $_bd_exit -eq 3 ]; then - echo >&2 "beads: database not initialized — skipping hook 'post-checkout'" - _bd_exit=0 - fi - if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi -fi -# --- END BEADS INTEGRATION v1.2.2 --- diff --git a/.beads/hooks/post-merge b/.beads/hooks/post-merge deleted file mode 100755 index 496f17508..000000000 --- a/.beads/hooks/post-merge +++ /dev/null @@ -1,33 +0,0 @@ -#!/usr/bin/env sh -# --- BEGIN BEADS INTEGRATION v1.2.2 --- -# This section is managed by beads. Do not remove these markers. -if command -v bd >/dev/null 2>&1; then - export BD_GIT_HOOK=1 - _bd_timeout=${BEADS_HOOK_TIMEOUT:-300} - _bd_used_perl=0 - if command -v timeout >/dev/null 2>&1; then - timeout "$_bd_timeout" bd hooks run post-merge "$@" - _bd_exit=$? - elif command -v gtimeout >/dev/null 2>&1; then - gtimeout "$_bd_timeout" bd hooks run post-merge "$@" - _bd_exit=$? - elif command -v perl >/dev/null 2>&1; then - _bd_used_perl=1 - perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run post-merge "$@" - _bd_exit=$? - else - echo >&2 "beads: hook 'post-merge' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT" - bd hooks run post-merge "$@" - _bd_exit=$? - fi - if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then - echo >&2 "beads: hook 'post-merge' timed out after ${_bd_timeout}s — continuing without beads" - _bd_exit=0 - fi - if [ $_bd_exit -eq 3 ]; then - echo >&2 "beads: database not initialized — skipping hook 'post-merge'" - _bd_exit=0 - fi - if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi -fi -# --- END BEADS INTEGRATION v1.2.2 --- diff --git a/.beads/hooks/pre-commit b/.beads/hooks/pre-commit deleted file mode 100755 index b015c22f6..000000000 --- a/.beads/hooks/pre-commit +++ /dev/null @@ -1,33 +0,0 @@ -#!/usr/bin/env sh -# --- BEGIN BEADS INTEGRATION v1.2.2 --- -# This section is managed by beads. Do not remove these markers. -if command -v bd >/dev/null 2>&1; then - export BD_GIT_HOOK=1 - _bd_timeout=${BEADS_HOOK_TIMEOUT:-300} - _bd_used_perl=0 - if command -v timeout >/dev/null 2>&1; then - timeout "$_bd_timeout" bd hooks run pre-commit "$@" - _bd_exit=$? - elif command -v gtimeout >/dev/null 2>&1; then - gtimeout "$_bd_timeout" bd hooks run pre-commit "$@" - _bd_exit=$? - elif command -v perl >/dev/null 2>&1; then - _bd_used_perl=1 - perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run pre-commit "$@" - _bd_exit=$? - else - echo >&2 "beads: hook 'pre-commit' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT" - bd hooks run pre-commit "$@" - _bd_exit=$? - fi - if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then - echo >&2 "beads: hook 'pre-commit' timed out after ${_bd_timeout}s — continuing without beads" - _bd_exit=0 - fi - if [ $_bd_exit -eq 3 ]; then - echo >&2 "beads: database not initialized — skipping hook 'pre-commit'" - _bd_exit=0 - fi - if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi -fi -# --- END BEADS INTEGRATION v1.2.2 --- diff --git a/.beads/hooks/pre-push b/.beads/hooks/pre-push deleted file mode 100755 index 1d4c4cc22..000000000 --- a/.beads/hooks/pre-push +++ /dev/null @@ -1,33 +0,0 @@ -#!/usr/bin/env sh -# --- BEGIN BEADS INTEGRATION v1.2.2 --- -# This section is managed by beads. Do not remove these markers. -if command -v bd >/dev/null 2>&1; then - export BD_GIT_HOOK=1 - _bd_timeout=${BEADS_HOOK_TIMEOUT:-300} - _bd_used_perl=0 - if command -v timeout >/dev/null 2>&1; then - timeout "$_bd_timeout" bd hooks run pre-push "$@" - _bd_exit=$? - elif command -v gtimeout >/dev/null 2>&1; then - gtimeout "$_bd_timeout" bd hooks run pre-push "$@" - _bd_exit=$? - elif command -v perl >/dev/null 2>&1; then - _bd_used_perl=1 - perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run pre-push "$@" - _bd_exit=$? - else - echo >&2 "beads: hook 'pre-push' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT" - bd hooks run pre-push "$@" - _bd_exit=$? - fi - if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then - echo >&2 "beads: hook 'pre-push' timed out after ${_bd_timeout}s — continuing without beads" - _bd_exit=0 - fi - if [ $_bd_exit -eq 3 ]; then - echo >&2 "beads: database not initialized — skipping hook 'pre-push'" - _bd_exit=0 - fi - if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi -fi -# --- END BEADS INTEGRATION v1.2.2 --- diff --git a/.beads/hooks/prepare-commit-msg b/.beads/hooks/prepare-commit-msg deleted file mode 100755 index 63a92261d..000000000 --- a/.beads/hooks/prepare-commit-msg +++ /dev/null @@ -1,33 +0,0 @@ -#!/usr/bin/env sh -# --- BEGIN BEADS INTEGRATION v1.2.2 --- -# This section is managed by beads. Do not remove these markers. -if command -v bd >/dev/null 2>&1; then - export BD_GIT_HOOK=1 - _bd_timeout=${BEADS_HOOK_TIMEOUT:-300} - _bd_used_perl=0 - if command -v timeout >/dev/null 2>&1; then - timeout "$_bd_timeout" bd hooks run prepare-commit-msg "$@" - _bd_exit=$? - elif command -v gtimeout >/dev/null 2>&1; then - gtimeout "$_bd_timeout" bd hooks run prepare-commit-msg "$@" - _bd_exit=$? - elif command -v perl >/dev/null 2>&1; then - _bd_used_perl=1 - perl -e 'alarm shift; exec @ARGV' "$_bd_timeout" bd hooks run prepare-commit-msg "$@" - _bd_exit=$? - else - echo >&2 "beads: hook 'prepare-commit-msg' running without timeout; install coreutils or perl to enable BEADS_HOOK_TIMEOUT" - bd hooks run prepare-commit-msg "$@" - _bd_exit=$? - fi - if [ $_bd_exit -eq 124 ] || { [ $_bd_used_perl -eq 1 ] && [ $_bd_exit -eq 142 ]; }; then - echo >&2 "beads: hook 'prepare-commit-msg' timed out after ${_bd_timeout}s — continuing without beads" - _bd_exit=0 - fi - if [ $_bd_exit -eq 3 ]; then - echo >&2 "beads: database not initialized — skipping hook 'prepare-commit-msg'" - _bd_exit=0 - fi - if [ $_bd_exit -ne 0 ]; then exit $_bd_exit; fi -fi -# --- END BEADS INTEGRATION v1.2.2 --- diff --git a/.beads/metadata.json b/.beads/metadata.json deleted file mode 100644 index 46617a80a..000000000 --- a/.beads/metadata.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "database": "dolt", - "backend": "dolt", - "dolt_mode": "embedded", - "dolt_database": "archie_core", - "project_id": "e8a66150-1f5f-42d2-8653-dcf8463cef74", - "last_bd_version": "1.3.2" -} \ No newline at end of file diff --git a/.dockerignore b/.dockerignore index 575fe28df..6e950b0cf 100644 --- a/.dockerignore +++ b/.dockerignore @@ -10,8 +10,6 @@ bin/ dist/ docs/ -# Issue tracking is a Dolt database, not build input. -.beads/ tmp/ .playwright-mcp/ # A trailing-slash pattern matches only the context root, so this is written to diff --git a/.gitignore b/.gitignore index 2fb9c4dc3..b5e83013c 100644 --- a/.gitignore +++ b/.gitignore @@ -31,13 +31,8 @@ config.production.toml /.air/ /tmp/ -# Beads / Dolt files (added by bd init) .dolt/ -.beads-credential-key -.beads/proxieddb/ *.gate.lock* -.beads/issues.jsonl -.beads/interactions.jsonl .mcp.json # gh CLI state (~/.local/state/gh) mistakenly created inside the tree diff --git a/CLAUDE.md b/CLAUDE.md index 68105ca97..965632fe7 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -45,7 +45,7 @@ When sources disagree, the higher one wins: 1. The maintainer's instruction in this session. 2. This file. 3. The code as it is in the tree. -4. Beads issues (`bd show `): the plan for a piece of work. +4. Gitea issues (`tea issues view `): the plan for a piece of work. 5. Everything else (memories, comments, old docs) is a hint. Verify it against the code before acting on it. @@ -177,21 +177,32 @@ Requires Go 1.27, Task, golangci-lint, Node, pnpm and Docker. Adopt `task fmt` a Nothing in the working tree is read at runtime. Systemd is optional. - Releases: `RELEASING.md`. -## Issues (beads) +## Issues (Gitea) -Work is tracked in `bd`, never in Markdown TODO files. +Work is tracked as issues on the primary remote, never in Markdown TODO files. +GitHub is a read-only mirror; do not open, close or comment there. ```bash -bd ready | bd show | bd update --claim | bd close +tea issues list -r sam/archie --state open --labels priority::critical +tea issues list -r sam/archie --labels epic/ --state open +tea issues view 497 +tea issues edit 497 --add-labels status::in_progress --add-assignees sam +tea comment 497 "what changed, and what was run" +tea issues close 497 ``` - An issue is the plan: what is wrong or wanted, and how you know it is done. Keep it to that. -- Bead state syncs through Dolt (`bd dolt push/pull`, only when told), not git. - Never commit `.beads/` exports. -- No host names, IPs, paths, PIDs or credentials in any bead: they are - published. -- File follow-up work you find as a bead. Do not fix it in passing. +- Labels carry state: `type::`, `priority::`, `status::in_progress` and + `status::deferred`. Open/closed is the issue state, not a label. + `epic/` says which epic an issue belongs to. +- Cite the issue number in commits and comments. +- `tea issues list --labels` silently ignores an unknown name and returns every + issue. Check the count is plausible before trusting a filtered list. +- The API caps `limit` at 50 regardless of what you pass. +- No host names, IPs, paths, PIDs or credentials in an issue: the text outlives + the change that wrote it. +- File follow-up work you find as an issue. Do not fix it in passing. ## Changing this file diff --git a/docs/prds/external-agent-harness.md b/docs/prds/external-agent-harness.md index 491990332..000951322 100644 --- a/docs/prds/external-agent-harness.md +++ b/docs/prds/external-agent-harness.md @@ -219,7 +219,7 @@ phase differ. The proxy runs in the daemon outside the container, so a shell in the container sees only sentinels. - **Takeover (interactive PTY into a running task) is out of scope for this - bead.** It needs the dangerous-command authority (`archie-core-sod1`) to + issue.** It needs the dangerous-command authority (#1574) to gate it, and that authority is not wired for it: the harness listener has no approval step; `ToolSetOptions.Approval` in `internal/agentexec/modelloop` is never set by a caller, so task runs never build approval-required tools; diff --git a/prompts/organisation-automation/00-start-here.md b/prompts/organisation-automation/00-start-here.md index 6d7808216..8521b762b 100644 --- a/prompts/organisation-automation/00-start-here.md +++ b/prompts/organisation-automation/00-start-here.md @@ -3,8 +3,8 @@ Read this file and `GUIDELINES.md` before running a numbered implementation prompt. The maintainer approved the architecture below. Implement it; do not restart a navigation brainstorming exercise. The initial Antigravity navigation proposal -was rejected. A later externally authored design or Bead design field is not -additional approval. +was rejected. A later externally authored design or issue description field is +not additional approval. ## Approved product model @@ -43,14 +43,14 @@ that snapshot is current. Other agents may have worked since this handoff. ## Execution sequence -1. `01-execution-identities.md` — `archie-core-kgxw.13`. -2. `02-connections-and-repositories.md` — `archie-core-oygqd`. -3. `03-organisation-ownership.md` — `archie-core-3z4fd.8`. -4. `04-navigation-and-setup.md` — `archie-core-3z4fd.1`. +1. `01-execution-identities.md` — #300. +2. `02-connections-and-repositories.md` — #385. +3. `03-organisation-ownership.md` — #57. +4. `04-navigation-and-setup.md` — #47. -Beads is authoritative for progress and dependencies. The parent is -`archie-core-3z4fd`. These files are reusable instructions, not completion records. -Read each Bead before claiming it. Complete the current slice end to end before +Gitea issues are authoritative for progress and dependencies. The parent is +#1043. These files are reusable instructions, not completion records. +Read each issue before claiming it. Complete the current slice end to end before starting the next. Do not close the parent until all acceptance criteria have actual evidence. Do not delegate unless the maintainer explicitly authorises it. diff --git a/prompts/organisation-automation/01-execution-identities.md b/prompts/organisation-automation/01-execution-identities.md index 66ae717c8..9dbe73e7b 100644 --- a/prompts/organisation-automation/01-execution-identities.md +++ b/prompts/organisation-automation/01-execution-identities.md @@ -63,4 +63,4 @@ actual daemon path. Cover refused human, inactive, unassigned and cross-org identities; authority outages; retry rechecks; and absence of root credential inheritance. Verify a renamed agent still resolves by ID. Verify existing mapped identities retain their permissions. Run the project gate and record evidence -and any remaining limitations in the Bead before closing it. +and any remaining limitations in the issue before closing it. diff --git a/prompts/organisation-automation/04-navigation-and-setup.md b/prompts/organisation-automation/04-navigation-and-setup.md index 4c650f2b4..9eb153c28 100644 --- a/prompts/organisation-automation/04-navigation-and-setup.md +++ b/prompts/organisation-automation/04-navigation-and-setup.md @@ -51,4 +51,4 @@ loading/error states, keyboard access and a narrow viewport. Capture evidence, regenerate embedded UI output and run the exact final tree's project gate. Do not claim a successful user journey based solely on mocked screenshots or -fixture state. Leave unmet criteria explicitly open in Beads. +fixture state. Leave unmet criteria explicitly open in the issue. diff --git a/prompts/organisation-automation/GUIDELINES.md b/prompts/organisation-automation/GUIDELINES.md index f84ef6a8c..2d222f25a 100644 --- a/prompts/organisation-automation/GUIDELINES.md +++ b/prompts/organisation-automation/GUIDELINES.md @@ -7,9 +7,9 @@ AGENTS.md files first; the maintainer's current instructions take precedence. - Verify the requested checkout, branch, working tree and other active writers. Preserve unrelated changes. Do not reset, stash or overwrite another agent. -- Read and claim the named Bead. Create any missing issue before starting its - work. Record implementation discoveries and remaining work in Beads, never a - second Markdown task ledger. Do not sync Beads externally unless told. +- Read and claim the named issue. Create any missing issue before starting its + work. Record implementation discoveries and remaining work in the issue, never + a second Markdown task ledger. Do not post to another tracker unless told. - Trace the complete affected path: UI, API, service contract, authorisation, persistence, runtime consumer, retries, fixtures and generated artifacts. - Name the smallest complete change. Reuse existing resource, secret-reference, @@ -40,7 +40,7 @@ AGENTS.md files first; the maintainer's current instructions take precedence. - Remove obsolete paths only after migrating their data and callers. No parallel identity authority, duplicated ownership model or indefinite compatibility shim. - No new service, binary, generic framework, broad cleanup or speculative feature. - File unrelated discoveries as Beads instead of fixing them in passing. + File unrelated discoveries as issues instead of fixing them in passing. ## Verification and delivery @@ -57,9 +57,9 @@ AGENTS.md files first; the maintainer's current instructions take precedence. - Regenerate protobuf and embedded UI assets when their sources change; do not hand-edit generated output. Run appropriate targeted checks, then `task check` on the exact final tree before committing. Never run concurrent full gates. -- Stage only your own paths, never `.beads/`, binaries or scratch output. Commit - finished work with a short scoped Conventional Commit. Do not push or deploy. -- Close a Bead only when its stated acceptance is demonstrated. If something +- Stage only your own paths, never binaries or scratch output. Commit finished + work with a short scoped Conventional Commit. Do not push or deploy. +- Close an issue only when its stated acceptance is demonstrated. If something remains unverified, record exactly what and why; leave the issue open. Never describe a partial implementation as end-to-end completion. - Report what changed, what was verified and the material remaining limitation. diff --git a/tools/cloud-setup.sh b/tools/cloud-setup.sh index ad62464a9..89fc5e59d 100755 --- a/tools/cloud-setup.sh +++ b/tools/cloud-setup.sh @@ -44,9 +44,6 @@ go install "github.com/bufbuild/buf/cmd/buf@$BUF_VERSION" go install "google.golang.org/protobuf/cmd/protoc-gen-go@$PROTOC_GEN_GO_VERSION" go install "google.golang.org/grpc/cmd/protoc-gen-go-grpc@$PROTOC_GEN_GO_GRPC_VERSION" -curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash -(cd "$HOME" && bd setup claude --global) - # PostgreSQL 18 for e2e/stack.sh, which runs its own cluster. Never for # tests: they use fakes. if [ ! -x /usr/lib/postgresql/18/bin/postgres ]; then @@ -81,4 +78,3 @@ go version node --version task --version golangci-lint --version -bd --version diff --git a/ui/AGENTS.md b/ui/AGENTS.md index 76a0734d7..3b8854fbb 100644 --- a/ui/AGENTS.md +++ b/ui/AGENTS.md @@ -1,7 +1,7 @@ # UI agent rules These rules supplement the repository root's AGENTS.md. Its authority, service -boundaries, security invariants, Beads workflow and commit gate still apply. +boundaries, security invariants, issue workflow and commit gate still apply. CLAUDE.md points here so both agents use one policy. ## Scope @@ -127,8 +127,8 @@ pnpm audit # after dependency changes edit it by hand. Test-only edits do not need new dashboard assets. - Reuse a running dev server for browser checks. Verify changed interactions, not just a screenshot or successful HTTP response. -- Track work and follow-ups in Beads. Keep rules here only when they change a - decision; do not add task history or Markdown TODO lists. +- Track work and follow-ups as Gitea issues (`tea`). Keep rules here only when + they change a decision; do not add task history or Markdown TODO lists. ## Working with you