micro--go-micro
Asim Aslam
31556b310e
* ci: run the architect continuously as the founder lens Make the architect a continuous overseer (hourly at :59, just before the :29 increment) instead of an every-few-days check-in. Each run it tracks live state (what merged, what's in flight), keeps the roadmap priorities live, and judges cohesion across harness/framework/dev-UX plus missing pieces and realignment — re-ranking internal/docs/PRIORITIES.md to match reality. It only opens a PR when the ranking actually changes (otherwise it just posts an assessment and closes its issue), to avoid churn. * thesis: lead the North Star with the mission, grounded in the canon Instill the years of context the loop was missing: the vision lives in the corpus (blog, README, website), not a single doc. Lead THESIS.md with an explicit Mission — "what problem we solve" (make building an agent as easy as building a service, on one runtime, because an agent is a distributed system), distilled from the corpus — and name the blog/README/website as the canon the North Star is a distillation of and must stay faithful to. Wire the architect to judge every priority against the mission and re-derive alignment from the canon, flagging drift in either direction (work vs mission, or thesis vs the blog). --------- Co-authored-by: Claude <noreply@anthropic.com>
52 行
4.9 KiB
YAML
52 行
4.9 KiB
YAML
name: Architecture Review
|
|
|
|
# Continuous high-altitude oversight of the whole framework and harness — the
|
|
# "founder lens" of the autonomous loop (internal/docs/CONTINUOUS_IMPROVEMENT.md).
|
|
# Where DevRel watches the public story and the increment loop ships code, the
|
|
# architect watches the SYSTEM and runs alongside the builders: it tracks what is
|
|
# in flight and what just merged, keeps the roadmap priorities live, and judges
|
|
# cohesion (harness <-> framework <-> dev UX), missing pieces, and realignment.
|
|
#
|
|
# Its OUTPUT is the ranked queue in internal/docs/PRIORITIES.md plus an assessment
|
|
# — NOT large refactors. Breaking public-API and architectural changes stay with
|
|
# the human (see CONTINUOUS_IMPROVEMENT.md).
|
|
#
|
|
# Runs hourly, offset before the increment loop (:29) so it re-prioritizes and
|
|
# THEN the loop builds the new top of the queue. Opens a fresh issue and
|
|
# dispatches Codex via CODEX_TRIGGER_TOKEN.
|
|
|
|
on:
|
|
workflow_dispatch: {}
|
|
schedule:
|
|
- cron: "59 * * * *" # hourly at :59, just before the :29 increment run (tunable)
|
|
|
|
permissions:
|
|
issues: write
|
|
|
|
concurrency:
|
|
group: architecture-review
|
|
cancel-in-progress: false
|
|
|
|
jobs:
|
|
dispatch:
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- name: Open an architecture review issue and dispatch Codex
|
|
env:
|
|
GH_TOKEN: ${{ secrets.CODEX_TRIGGER_TOKEN || github.token }}
|
|
HAS_TRIGGER_TOKEN: ${{ secrets.CODEX_TRIGGER_TOKEN != '' }}
|
|
REPO: ${{ github.repository }}
|
|
RUN_NUMBER: ${{ github.run_number }}
|
|
run: |
|
|
if [ "$HAS_TRIGGER_TOKEN" != "true" ]; then
|
|
echo "CODEX_TRIGGER_TOKEN is not set — skipping (Codex ignores Actions-bot comments)."
|
|
exit 0
|
|
fi
|
|
ISSUE_URL=$(gh issue create --repo "$REPO" \
|
|
--title "Architecture review #$RUN_NUMBER" \
|
|
--body "Continuous architecture / harness oversight against the North Star in internal/docs/THESIS.md. Output: a re-ranked internal/docs/PRIORITIES.md (only if it changed) plus an assessment.")
|
|
ISSUE_NUM="${ISSUE_URL##*/}"
|
|
echo "Opened issue #$ISSUE_NUM — dispatching Codex (Architect)."
|
|
gh issue comment "$ISSUE_NUM" --repo "$REPO" --body \
|
|
"@codex Act as the architect — the founder lens — for go-micro, running continuously alongside the builders. Hold the whole picture: how the harness, the framework, and the developer UX fit together cohesively, what is in flight and what just merged, what to prioritize next on the roadmap, and what is missing or has drifted. Each run: (1) TRACK STATE — scan recently merged PRs and open codex PRs/issues to see what shipped and what is being built right now, so the queue reflects reality (drop done items, don't re-queue in-flight work). (2) ASSESS against the North Star in internal/docs/THESIS.md — lead with its Mission (*the problem we solve: make building an agent as easy as building a service, on one runtime*) and re-derive alignment from the CANON it names (the blog under internal/website/blog, the README, and the website — read these, don't rely on THESIS.md alone), then ROADMAP.md (Now → Next → Later). Judge every priority against the mission: does it make the services → agents → workflows lifecycle simpler, more cohesive, and more operable? Look at coherence and seams across the core packages (agent, ai, flow, gateway/mcp, gateway/a2a, model, server, store, registry), the dev inner loop (scaffold → run → chat → inspect → deploy), missing pieces, duplication/drift, and realignment. Flag drift in EITHER direction: work drifting from the mission, or the North Star/website drifting from the lived story in the blog (which needs re-grounding in the canon). (3) MAINTAIN THE QUEUE in internal/docs/PRIORITIES.md — a SINGLE ordered list, highest-value first, each item linking a scoped CI-verifiable issue (#N); roadmap phase is the primary ordering, internal findings (cohesion gaps, DX friction, missing pieces) interleaved by value. For any prioritized gap that has no issue yet, file one: \`gh issue create --label codex --label enhancement --title \"<scoped task>\" --body \"<goal, scope, acceptance criteria>\"\`. OUTPUT: post a concise assessment as a comment on this issue (#$ISSUE_NUM) — what shipped, what's in flight, the top risks/gaps/missing pieces, and the reasoning behind the ranking. If the ranking actually changed, open ONE PR for PRIORITIES.md: \`git switch -c codex/architect-$ISSUE_NUM\`, \`git push -u origin codex/architect-$ISSUE_NUM\`, \`gh pr create --base master --label codex --title \"<title>\" --body \"<summary, Closes #$ISSUE_NUM>\"\`, then \`gh pr merge --squash --auto --delete-branch\`. If the queue is already accurate and correctly ranked, do NOT open a PR — just close this issue (\`gh issue close $ISSUE_NUM\`). Do NOT make breaking public-API or architectural changes yourself — surface those in the assessment as notes for the human, never as auto-merged changes. Do not use the make_pr tool (it is a no-op stub)."
|