Skip to content

Enforce issue-linked target workflow prompts#35

Merged
OziinG merged 7 commits intomainfrom
cc-75-github-workflow-prompt
Apr 30, 2026
Merged

Enforce issue-linked target workflow prompts#35
OziinG merged 7 commits intomainfrom
cc-75-github-workflow-prompt

Conversation

@OziinG
Copy link
Copy Markdown
Contributor

@OziinG OziinG commented Apr 30, 2026

Summary

  • Enforce target-repository work as a GitHub issue-linked workflow in the root agent contract.
  • Add scoped target-work guidance to the bootstrap skill after target repo creation.
  • Update the target repo AGENTS template to require target issue, optional change-control issue, GitHub Development branch creation, linked branch verification, PR-to-dev, validation, merge, cleanup, and reporting rules.
  • Define the local folder structure: the three control-plane repos live under <CLEVER_ROOT>/clever-agent-workspace/, and product/service target repos live under <CLEVER_ROOT>/projects/<project-slug>/<target-repo>/ where agent seed documents are injected.
  • Add Python preflight workspace_check.session_open_check so bootstrap validation confirms the CLEVER_ROOT-based session layout before startup questions.
  • Add preflight_check.agent_response_contract so prompts received at <CLEVER_ROOT> do not trigger ad-hoc work; the agent first inherits the CLEVER workflow, completes initial setup, then continues with the user's prompt.
  • Add a concise GitHub README copy-paste prompt: create a CLEVER root folder, fetch the three control-plane repos, then follow clever-agent-project to prepare the work.
  • Update regression tests for the branch/PR workflow, project checkout layout, session-root validation, root-prompt response style, and README prompt.

Intended folder layout

<CLEVER_ROOT>/
  clever-agent-workspace/
    clever-agent-project/
    clever-context-monorepo/
    clever-change-control/
  projects/
    <project-slug>/
      <target-repo>/
        AGENTS.md
        docs/project-brief.md
        .github/PULL_REQUEST_TEMPLATE.md
        scripts/apply-github-rulesets.sh

README root prompt shape

The README now provides a short user-facing prompt that says, in effect:

새 CLEVER 작업 루트를 하나 만들고, clever-agent-workspace 아래에 3대 레포를 받은 뒤, clever-agent-project의 README/AGENTS 지침에 따라 preflight와 작업 준비를 진행해줘. 초기 준비 전에는 구현/커밋/PR을 시작하지 말고, 준비가 끝나면 다음 작업은 주신 프롬프트대로 진행하겠다고 답해줘.

Linked issues

Concurrent Work Gate

Validation

  • python3 -m pytest -q — 84 passed, 2 skipped
  • python3 .agent/skills/bootstrap-clever-work/scripts/bootstrap_clever_work.py --cwd "$PWD" --workspace-check --json — emitted workspace_check.session_open_check (legacy-layout in this current checkout, with expected nested path reported)
  • python3 -m py_compile .agent/skills/bootstrap-clever-work/scripts/bootstrap_clever_work.py — passed
  • git diff --check — passed
  • npm/Gradle target app commands — not applicable; this control-plane repo has no package or service backend manifest

Notes

  • This control-plane repository uses main as the protected PR base; the prompt changes themselves instruct target repositories to use work branches from dev and PRs into dev.

Constraint: Non-trivial target repo work must be blocked until target and change-control issues plus a GitHub Development linked branch exist.\nRejected: Keep role-prefixed manual task branches | They allow work to start without issue-linked GitHub Development traceability.\nConfidence: high\nScope-risk: narrow\nDirective: Preserve the issue -> change-control -> gh issue develop -> PR to dev sequence when editing target workflow prompts.\nTested: python3 -m pytest -q; git diff --check\nNot-tested: npm/Gradle target app commands; this repository has no package or service backend manifest.
OziinG added 6 commits April 30, 2026 17:54
Constraint: Control-plane repositories must remain together while product repositories need a predictable local home for seeded agent documents.\nRejected: Clone target repos directly beside the three control-plane repos | It blurs the control-plane root with product workspaces.\nConfidence: high\nScope-risk: narrow\nDirective: Keep three agent repos under <CLEVER_ROOT> and target repos under <CLEVER_ROOT>/projects/<project-slug>/<target-repo>.\nTested: python3 -m pytest -q; git diff --check\nNot-tested: live target repo bootstrap clone; this change updates prompt/script packet contracts only.
Constraint: The CLEVER root separates the agent workspace from product project checkouts.\nRejected: Place control-plane repos directly under <CLEVER_ROOT> | The intended root has a clever-agent-workspace child containing the three agent repos.\nConfidence: high\nScope-risk: narrow\nDirective: Keep agent repos in <CLEVER_ROOT>/clever-agent-workspace and target repos in <CLEVER_ROOT>/projects/<project-slug>/<target-repo>.\nTested: python3 -m pytest -q; git diff --check\nNot-tested: live clone into the corrected folder layout.
Constraint: Python preflight must confirm the CLEVER_ROOT session layout before startup work begins.\nRejected: Only document the layout | The bootstrap packet also needs machine-readable session_open_check evidence.\nConfidence: high\nScope-risk: moderate\nDirective: Read workspace_check.session_open_check before startup questions; target repos belong under <CLEVER_ROOT>/projects even when a legacy direct layout is detected.\nTested: python3 -m pytest -q; python3 .agent/skills/bootstrap-clever-work/scripts/bootstrap_clever_work.py --cwd "/Users/jiin/Documents/Files/03_Work_EVnSolution/01_Repos/03_CLEVER_Agent/clever-agent-project" --workspace-check --json; git diff --check\nNot-tested: live nested <CLEVER_ROOT>/clever-agent-workspace checkout with real git remotes.
Constraint: Prompts received at CLEVER_ROOT must not trigger ad-hoc implementation before the agent workflow is inherited.\nRejected: Rely on prose-only startup guidance | The preflight now exposes agent_response_contract so the response style is machine-readable.\nConfidence: high\nScope-risk: narrow\nDirective: First response should state that initial setup runs first, then continue with the provided prompt after repo/rules/pull/agent-document injection succeeds.\nTested: python3 -m pytest -q; python3 .agent/skills/bootstrap-clever-work/scripts/bootstrap_clever_work.py --cwd "/Users/jiin/Documents/Files/03_Work_EVnSolution/01_Repos/03_CLEVER_Agent/clever-agent-project" --workspace-check --json; python3 -m py_compile .agent/skills/bootstrap-clever-work/scripts/bootstrap_clever_work.py; git diff --check\nNot-tested: end-to-end live target repo creation and ruleset application.
Constraint: Users need a copy-paste prompt for agents opened at CLEVER_ROOT that prevents ad-hoc implementation.\nRejected: Only describe the folder layout | Users need a concrete prompt that makes agents inherit the CLEVER workflow first.\nConfidence: high\nScope-risk: narrow\nDirective: Keep the root-level prompt aligned with session_open_check and agent_response_contract.\nTested: python3 -m pytest -q; python3 -m py_compile .agent/skills/bootstrap-clever-work/scripts/bootstrap_clever_work.py; git diff --check\nNot-tested: live first-run copy-paste into a fresh agent session.
Constraint: The README prompt should be a short user-facing instruction, not an exhaustive procedure dump.\nRejected: Long CLEVER_ROOT preflight prompt | It obscured the core action: create a folder, fetch the three repos, then follow agent-project.\nConfidence: high\nScope-risk: narrow\nDirective: Keep the root prompt concise and defer operational details to clever-agent-project README/AGENTS.\nTested: python3 -m pytest -q; python3 -m py_compile .agent/skills/bootstrap-clever-work/scripts/bootstrap_clever_work.py; git diff --check\nNot-tested: live copy-paste into a fresh agent session.
@OziinG OziinG merged commit 19ede77 into main Apr 30, 2026
4 checks passed
@OziinG OziinG deleted the cc-75-github-workflow-prompt branch April 30, 2026 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Enforce GitHub issue-linked development workflow in prompts

1 participant