Initial design #1

Merged
prskr merged 8 commits from design/initial into main 2026-10-17 12:19:46 +00:00
Owner
No description provided.
- product/: context (vision, requirements, decision index, future
  options F1-F9) and the iteration 1 plan
- design/: tech stack, ADR-0001 to ADR-0032 (all accepted), deep dives
  for agent runs, sandbox egress and deployment
- contract/: agent protocol and transcript schema (protobuf),
  integrations plugin package (WIT, with vendored WASI 0.2.12 and
  wasi:config deps), factory tool schemas

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FQiLK7xTtLcxGXNtANpgNW
ADR-0029 lists Envoy with Lua/Wasm filters as a considered alternative:
it would only replace the CONNECT proxy while the allowlist decision,
live log, Git proxy, MCP and inference endpoints stay custom. The
per-connection allowlist decision is kept as an internal interface so
Envoy could later replace just the egress proxy via ext_authz.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FQiLK7xTtLcxGXNtANpgNW
- ADR-0033: per-project branch rewrite policy (never / with-lease /
  always), fan-out across branches via child tasks, "PR merged"
  dependency trigger, forge capabilities to list open PRs and read CI
  checks; ADR-0025 marked as amended
- agent-run.md: push with --force-with-lease when the policy allows,
  lease mismatch failure handling, Git proxy ref enforcement
- contract/README.md: planned pull-requests.list-open, checks
  capability and rewrite policy in Assign.workspace
- product/agent-playbook.md: principles and patterns as the source for
  built-in and project skills (renovate pile-up, implement and review)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FQiLK7xTtLcxGXNtANpgNW
- ADR-0034: tasks form a tree of any depth with flat keys; group tasks
  without an agent; subtask_base (default-branch / parent-branch) and
  subtask_merge (human / parent-agent) resolved task -> ancestors ->
  project -> instance; agents may only tighten them; agents never merge
  into non-task branches; events, lifecycle and limits along the tree
- ADR-0016 marked as amended; ADR-0026 related
- agent-run.md: base branch may be the parent's task branch
- contract/README.md: pull-requests.merge, branches.create, factory
  tools for creating subtasks and merging subtask PRs
- agent-playbook.md: delegation guidance and "big feature in
  iterations" pattern

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FQiLK7xTtLcxGXNtANpgNW
- ADR-0035: one responsive web UI; starting tasks, transcripts,
  questions, chats and task tree work on a phone; workspace changes,
  egress log, configuration and audit views are desktop-only
- ADR-0036: feedback on changes (code review) is out of scope; review
  happens on the forge pull request, the changes view is read-only
- ADR-0037: Tailwind CSS v4 via its standalone binary, pinned in Bazel,
  output embedded; classes as string literals in maud templates
- context.md, agent-run.md, iteration-1.md, tech-stack.md and the agent
  playbook updated accordingly

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FQiLK7xTtLcxGXNtANpgNW
- ADR-0038: questions (free text, suggested answers) and typed approval
  requests (network-access, tool-access, repository-mcp-server,
  push-check-exception, harness-permission, instance-operation); the
  control plane applies approved actions; approver picks the scope;
  blocking or non-blocking; one inbox and audit trail
- egress.md: denied hosts open network-access requests; resolves the
  open questions on agent-requested allowlist additions and notifying
  running agents
- agent-run.md, contract/README.md, context.md, iteration-1.md updated
- agent-playbook.md: section on deciding, asking and requesting

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FQiLK7xTtLcxGXNtANpgNW
prskr merged commit f26131f78f into main 2026-10-17 12:19:46 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
prskr/dark-factory!1
No description provided.