stackchain/stackchain-hackathon
1
0
Fork 0
Code Issues 50 Pull Requests Actions Packages Projects Releases Wiki Activity
main
stackchain-hackathon/docs/agent-engineering-report.md
timmy 45688e5129
Some checks are pending
CI / lint (push) Waiting to run
Details
CI / pages-check (push) Blocked by required conditions
Details
Release Candidate / tag (push) Waiting to run
Details
Release Candidate / draft (push) Blocked by required conditions
Details
docs: add agent engineering visual report (markdown + html)
2026-07-08 15:49:27 +00:00

4.8 KiB
Raw Permalink Blame History

Stackchain AI Lab — Agent Engineering Report

Audience: agent engineers
Date: 2026-07-08
Status: Operations active, prototypes shipping, release candidates pending human test only

1. Current State — What We Have Built

Layer Artifact Status Evidence
Infra Gitea 1.22.0 on VPS, Caddy-free routing Live https://forge.alexanderwhitestone.com/git/
Org stackchain org, 4 repos, 5 users Live Repos: hackathon, dashboard, agent-todo-tracker, project-template
Auth Least-privilege tokens per agent/user Live timmy org-admin, turdbot bot, admin CLI
Pipeline CI + RC workflows in .gitea/workflows Live Push to main auto-tags + drafts RC
Loop Autonomous issue→PR→review→merge/no-spam Locked Stale 72h, close +24h, velocity #Velocity
Agent agent-todo-tracker CLI shipped Done init/create/list/update/close, SQLite storage
Kanban Hermes board + Gitea label sync Wired scripts/gitea_sync.py
Creative Hou3 dispatcher profile (Tencent Hy3) Active Assigned to #16/#17/#18, composing deliverables

2. Operational Constraints — Read This First

  • No Caddy changes for Gitea work. Period.
  • No human devops. Humans only: review prototype, test RC, approve ship.
  • Cached config: /etc/gitea/app.ini ROOT_URL=https://forge.alexanderwhitestone.com/git/
  • Asset path: /var/lib/gitea/public/assets/ — verified exists
  • Pages status: Repo Pages API returns 404; enablement gated on human config handoff
  • Dupe cleanup: john/JohnGalt removed; john52galt retained
  • Admin roster: rockachopa, timmy, grepples, john52galt

3. Market Fit Matrix — What We Can Build Next

Idea Market Signal Fit Build Order
Adaptive UI dashboard Developers want intelligent, context-aware interfaces Strong P0 — already scoped in #8, needs fleshed panels
Agent Task Harness Multi-agent orchestration is table stakes for agentic startups Strong P1 — deterministic routing, retry, circuit break
Agent Memory Store Every agent needs persistent memory across sessions Strong P1 — shared KV store, embeddings optional
PR Review Agent Automated code review reduces human review load Strong P1 — inline comments, label-based auto-merge
Repo Scaffolder Agent Natural-language project generation lowers onboarding friction Medium P2 — templates + agent-driven file gen
Hou3 creative pipeline Marketing/docs automation for launch velocity Medium P2 — release notes, overlay variants, README polish
Gitea Pages site Public landing page for the lab Medium Blocked on Pages enablement
Kanban-to-issue sync Single pane of glass for ops Medium Wired but untested at scale

4. Recommended Sequencing — Take It to the Next Level

Phase A — Close the Loop (0–48h)

  1. Ship dashboard panels. Turn the scaffold in stackchain-dashboard into a clickable, adaptive UI. Map panels to concrete Gitea views: review queue, issue triage, repo health.
  2. Wire Hou3 output to PRs/issues. Move from “drafting” to “posting review comments” on assigned issues. Close #16, #17, #18 with actual deliverables.
  3. Run the first full autonomous cycle. Pick one P1 issue, branch it, implement, open PR, self-review, merge. Prove the loop without spam.

Phase B — Harden (48h–2w)

  1. Add tests. The dashboard and agent-todo-tracker need real pytest suites. CI already runs them — fill the gap.
  2. Token rotation cadence. Automate via cron or a Hermes job. Don’t rely on manual rotation.
  3. Resource audit. 8GB RAM VPS. Model: Gitea + Caddy + N agents + dashboard. Profile before adding more workers.

Phase C — Scale (2w+)

  1. Multi-repo velocity. Queue issues across stackchain/*, not just hackathon.
  2. External preview URLs. Each RC gets a unique staging target. Humans click, test, approve.
  3. Hou3 specialization. Split creative dispatch into its own queue with different acceptance criteria than code agents.

5. Risk Register

Risk Likelihood Mitigation
Gitea Pages never enables via API Medium Surface as explicit human handoff in #14; do not block other work
8GB RAM exhaustion Medium Add memory watchdog; serialize worker starts
Duplicate accounts / auth drift Low Single admin path through Timmy; audit weekly
CI workflow YAML drift Medium One canonical workflow source; no mirroring
Hou3 repeats itself / spams comments Medium Seen-state tracking in dispatch.state; max-comment guard

6. One-Liner Direction

Ship adaptive UI, prove the loop, harden tests, keep humans on prototype/RC gate only.