Skip to content

Docs: rewrite getting-started guide for webhook-only, two-image, autonomous devloop #80

@zbloss

Description

@zbloss

What to build

Rewrite docs/getting-started.md to reflect the new architecture: two images (no poller, no Discord bot), webhook ingress as a hard prerequisite, fully autonomous Dev Loop with no approval gates, and all new Helm values documented.

Acceptance criteria

  • Step 1 is webhook ingress setup: documents Cloudflare Tunnel (reference docs/cloudflare-tunnel.md), cloud load balancer, and ngrok as options; explains that https://<your-domain>/webhook/github must be reachable by GitHub
  • Step 2 documents creating the GitHub webhook in the enrolled repo pointing at the tunnel URL, subscribing to issues, pull_request_review, and issue_comment events
  • github-webhook-secret Kubernetes Secret creation documented
  • devloop-bot setup documented: create a GitHub account, generate a fine-grained PAT with Contents/Pull requests/Issues (read/write) and Checks (read) permissions, create the PAT as a Kubernetes Secret
  • getting-started.md documents all new Helm values: temporalWorker.maxConcurrentJobs, temporalWorker.ciFixMaxIterations, temporalWorker.executeMaxIterations, temporalWorker.maxQuestionsPerPhase, temporalWorker.agentGithubLogin, agent.gitName, agent.gitEmail, summarization.enabled, summarization.cronSchedule, summarization.webhookUrl
  • Expected pods section shows only two devloop pods (devloop-agent-base not a running pod; devloop-temporal-worker is the only long-running deployment)
  • "How issue triggering works" section describes the webhook model, not the polling model
  • No references to poller, discordBot, Discord tokens, or approval gates remain
  • Project Registry schema table updated: pr_reviewer docstring updated to "GitHub login requested as reviewer after CI Fix Loop and Review phases complete"
  • Configuration reference table updated to remove poller/Discord settings and add all new settings

Blocked by

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions