Use when the user wants a high-stakes decision debated by independent perspectives and synthesized into a verdict — five advisors (Contrarian, First Principles, Expansionist, Outsider, Executor) answer independently, peer-review anonymously, then a chairman synthesizes. Triggers on: "council this", "convene the council", "run a council on", "rerun the council", "I want the council to debate this", "five independent perspectives", "have advisors weigh in and peer-review each other".
Use when the user wants a plan, proposal, or conclusion adversarially challenged in one pass — auto-picks the strongest critique mode (socratic, dialectic, pre-mortem, red-team, evidence audit) and delivers the 3–5 strongest challenges plus a synthesis. Triggers on: "court-jester this", "poke holes in this plan", "red-team this design", "run a pre-mortem", "argue the other side", "does the evidence actually support this conclusion", "challenge this proposal".
Use when interacting with a Gitea instance or its `tea` CLI — listing or filing issues, managing pull requests, labels, milestones, releases, repos, or calling the Gitea REST API. Triggers on: "tea" CLI commands, "Gitea", "tea issues", "tea pr", "tea api", blocked-by/issue dependencies, "file this on the tracker", or a repo whose remote points at a Gitea host. Excludes GitHub's `gh` CLI.
Use when documentation must stay truthful as software changes — writing or revising a spec, ADR, runbook, or API/config reference, splitting user-facing docs by purpose, or reconciling documentation drift. Triggers on: "write a spec", "ADR", "runbook", "which docs must change", "documentation drift", "missing acceptance criteria", "spec interview", "update the API reference".
Use when the project's domain model is being changed — terms pinned down, design decisions landing, vocabulary conflicting — or when another skill needs to maintain the domain model while decisions land. Triggers on: "pin down the terminology", "ubiquitous language", "record this decision", "add it to the glossary", "domain model".
Interactive QA session: the user reports bugs or issues conversationally, the agent clarifies, explores the codebase in the background for domain language, and files durable, user-focused issues on the project tracker. Triggers on: "QA session", "let's do QA", "file an issue for this", "report a bug", "log these bugs", "bug triage", or when the user describes problems they want captured as tracker issues rather than fixed immediately.
Use when a git merge or rebase is stopped mid-way with conflicting files. Triggers on: "merge conflict", "rebase conflict", "CONFLICT (content)", "fix these conflicts", "continue the rebase".
Configure the current project for the workflow skills — issue tracker bindings, triage label vocabulary, and domain doc layout. Run once per repo before first use of wayfinder, to-tickets, to-spec, triage, qa, or two-axis-review.