README as landing page, practitioner docs, changelog, and repo health signals

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: Something in agentfactory doesn't work as documented
+title: ''
+labels: bug
+assignees: ''
+---
+
+## What happened
+
+<!-- What did you run, what did you expect, what happened instead -->
+
+## Reproduction
+
+```bash
+# exact commands, starting from a known state
+```
+
+## Environment
+
+- OS:
+- Go version (`go version`):
+- Python version (`python3 --version`):
+- tmux version (`tmux -V`):
+- Install path: source build / quickstart.sh / quickdocker.sh
+
+## Relevant output
+
+```
+# af output, tmux capture, or hook logs
+```

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Propose a capability or improvement
+title: ''
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+<!-- What can't you do today, or what is harder than it should be -->
+
+## Proposed behavior
+
+<!-- What you'd like agentfactory to do. Commands/flags sketches welcome -->
+
+## Alternatives considered
+
+<!-- Workarounds you tried, or why existing features don't cover this -->

.github/workflows/visibility-health.yml

@@ -0,0 +1,64 @@
+# Monthly repo-health watchdog: verifies the discoverability surface (topics,
+# description, release, README badges) hasn't regressed and opens a single
+# issue when it has. Checks only — never commits, never touches content.
+name: visibility-health
+
+on:
+  schedule:
+    - cron: '17 8 3 * *'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  issues: write
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    env:
+      GH_TOKEN: ${{ github.token }}
+      REPO: ${{ github.repository }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check discoverability surface
+        run: |
+          problems=""
+
+          topics=$(gh api "repos/$REPO" --jq '.topics | join(" ")')
+          for t in claude-code ai-agents multi-agent-systems agentic-ai golang; do
+            case " $topics " in
+              *" $t "*) ;;
+              *) problems="$problems- topic \`$t\` is missing\n" ;;
+            esac
+          done
+
+          desc=$(gh api "repos/$REPO" --jq '.description // ""')
+          [ -n "$desc" ] || problems="$problems- repo description is empty\n"
+
+          if ! gh api "repos/$REPO/releases/latest" --jq .tag_name >/dev/null 2>&1; then
+            problems="$problems- no published release\n"
+          fi
+
+          grep -q 'actions/workflows/test.yml/badge.svg' README.md \
+            || problems="$problems- CI badge missing from README\n"
+          grep -q 'img.shields.io/github/license' README.md \
+            || problems="$problems- license badge missing from README\n"
+
+          if [ -z "$problems" ]; then
+            echo "All visibility checks passed."
+            exit 0
+          fi
+
+          echo "Regressions found:"
+          printf '%b' "$problems"
+
+          title="Visibility health check: regressions found"
+          existing=$(gh issue list --repo "$REPO" --state open \
+            --search "\"$title\" in:title" --json number --jq 'length')
+          if [ "$existing" -gt 0 ]; then
+            echo "Open issue already exists — not filing a duplicate."
+            exit 0
+          fi
+
+          body=$(printf 'The monthly visibility health check found regressions:\n\n%b\nRestore these — they are the repo'"'"'s discoverability surface (topics pages, search snippets, README badges).' "$problems")
+          gh issue create --repo "$REPO" --title "$title" --body "$body"

CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+Notable changes to agentfactory. The project began 2026-05-01; snapshot tags `V001`–`V012`
+mark pre-release checkpoints. `v0.1.0` is the first formal release.
+
+## v0.1.0 — 2026-07-11
+
+First formal release, consolidating ten weeks of development.
+
+### Orchestration core
+
+- Formula system: declarative TOML workflows with steps, DAG dependencies, variables, and
+  gates; `af sling --formula` instantiation and `af prime`/`af done` step tracking (#2)
+- Agent generation from formulas: `af formula agent-gen` creates workspace, role template,
+  and hook configuration with no manual file moves (#8)
+- Skill-to-formula pipeline: `/formula-create` turns a `SKILL.md` into a runnable formula;
+  built-in skills embedded and extracted during `af install --init` (#16)
+- Prime-before-done enforcement with velocity tracking, formula skill validation, and
+  per-agent model/endpoint configuration (#43, #81)
+- Startup.json-driven `af up` with declarative agent subset selection, dispatcher
+  auto-start, and scoped watchdog (#58)
+
+### Reliability & recovery
+
+- Mandatory step execution block and fidelity hook corrections for agents drifting off
+  formula steps (#26, #28)
+- Worktree isolation hardening: dispatched agents get independent worktrees; teardown gated
+  on session termination; branch-committed skills preserved (#30, #32, #61, #69)
+- Unified reset semantics: `af sling --reset` and `af down --reset` perform identical full
+  cleanup — worktrees, open work items, runtime state, checkpoints (#40)
+- Gate locks migrated to `.runtime` with stale-PID recovery (#43)
+- Test/production tmux isolation with build-tag-gated constructor guard; compact-handoff
+  PreCompact hook for context-compression safety (#52)
+- Agents made default-branch-agnostic; regen/lint CI gates (#63)
+
+### Multi-agent coordination
+
+- Inter-agent mail over the issue store, with broadcast groups and reply threading
+- Autonomous dispatch: PR/issue label matching, multi-label AND semantics, dispatch cycle
+  locking, idle back-off, phase advancement, and issue→PR handoff (#36, #38, #79)
+- MergePatrol PR-review agent with label-based discovery (#36)
+
+### Formula & agent library
+
+- rapid-implement, rapid-increment, ultra-review formulas (#65); web-design agent with
+  consensus gate (#68); minimalworker (#52); the fable agent family — fable-implement,
+  fable-increment, fable-review (#83)
+
+### Web console
+
+- Loopback-only web console: Floor view, task slinging, dispatch status, settings, design
+  prototypes; singleton-launch rendezvous; agent detail and operator mail (#72, #81, #83)
+- Browser formula authoring (#83)
+
+### Platform & tooling
+
+- Containerized setup via `quickdocker.sh` + `quickstart.sh`; stack-agnostic customer repo
+  discovery (#56); iOS build-host configuration with ssh-agent forwarding (#48, #50)
+- Server-wide tmux mouse/clipboard UX at session creation (#77)
+- CI: unit, integration, template-regen, and supply-chain-lint jobs
+
+[Full commit history](https://github.com/stempeck/agentfactory/commits/main)