Observe-first onboarding — connect existing repos without interference (quiet mode, UI-operated projects)
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 71
- Forks
- 64
- Avg merge
- 15h 38m
- Merged PRs (30d)
- 66
Description
Teams with a working SDLC must be able to connect Facility without it touching their repositories, and then opt in progressively. This is the brownfield adoption path — the difference between "rip out your process to try this" and "connect it in five minutes and click a button when curious". The platform lane already covers most of it; the gaps are noise and defaults.
What already works (verified on a live deployment)
- A repository connected without kickstart vendors nothing and provisions nothing.
- Comment commands are ignored by default:
laneFor()routes/architect-style comments to the platform only whenrender_answers.execution_laneis explicitly set. - The control-plane trigger (
POST /v1/projects/:id/issues/:number/trigger) deliberately bypasses the lane gate, so operating from the UI works today. - The issue mirror is read-only by design; multi-repo aggregation is #25.
Gaps for a true observe-first mode
- Quiet mode (per project or per repository): today even a UI-triggered run posts an acknowledgement comment, and the architect maintains progress and publishes its plan as issue comments. Quiet mode: no acknowledgement, no progress comments, the plan reviewed in the platform, and at most one opt-in summary comment. Pull requests and human feedback still flow through GitHub.
- Scheduled crew enabled on day one:
seedProjectHarnessAgentscreates project-owner and learning agents on daily schedules, enabled. Observe-first projects need them off by default, or an explicit project-level autonomy setting that gates schedules. execution_laneneeds a product surface (project settings) rather than a database write, keeping the safe default it already has.- Command namespacing: a configurable prefix (for example
/fx architect) so comment mode can coexist with an incumbent automation that already owns/architect-style commands. - Least-privilege install guidance: observe-only projects do not need write access to contents, issues or pull requests — document a read-scoped App variant or split the scopes.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by tracing the existing laneFor() gate, POST /v1/projects/:id/issues/:number/trigger, seedProjectHarnessAgents, and render_answers.execution_lane behavior. Define the project or repository settings and permission guidance needed for quiet, observe-first operation, then verify that UI-triggered runs avoid unsolicited comments and scheduled agents remain safely disabled until opted in.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github, typescript
- Domain
- backend, documentation, full-stack
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 30/100