---
phase: 05-aitp-x-gsd-workflow-contract
plan: 01
type: execute
wave: 1
depends_on: ["04-01"]
files_modified: [docs/AITP_GSD_WORKFLOW_CONTRACT.md, README.md, research/knowledge-hub/README.md, research/knowledge-hub/tests/test_agent_bootstrap_assets.py]
autonomous: true
requirements: [ACC-02]
user_setup: []
must_haves:
  truths:
    - Repo docs explain when to use GSD versus AITP.
    - Code inside a research topic is explicitly routed to AITP rather than generic repo workflow.
  artifacts:
    - path: docs/AITP_GSD_WORKFLOW_CONTRACT.md
      provides: explicit coexistence rule
  key_links:
    - from: docs/AITP_GSD_WORKFLOW_CONTRACT.md
      to: README.md
      via: repo entrypoint docs
      pattern: AITP_GSD_WORKFLOW_CONTRACT
---

<objective>
Make the everyday coexistence rule explicit: GSD for repo implementation work,
AITP for topic-governed research work.

Purpose: remove ambiguity about where code-backed research and repo maintenance diverge.
Output: workflow contract doc plus README/test wiring.
</objective>

<execution_context>
@D:/BaiduSyncdisk/Theoretical-Physics/.codex-home/get-shit-done/workflows/execute-plan.md
@D:/BaiduSyncdisk/Theoretical-Physics/.codex-home/get-shit-done/templates/summary.md
</execution_context>

<context>
@docs/HUMAN_IDEA_AI_EXECUTION_STEERING_PROTOCOL_VNEXT.md
@README.md
@research/knowledge-hub/README.md
</context>

<tasks>
<task type="auto">
  <name>Task 1: Write and wire the AITP x GSD workflow contract</name>
  <files>docs/AITP_GSD_WORKFLOW_CONTRACT.md, README.md, research/knowledge-hub/README.md, research/knowledge-hub/tests/test_agent_bootstrap_assets.py</files>
  <read_first>docs/HUMAN_IDEA_AI_EXECUTION_STEERING_PROTOCOL_VNEXT.md, README.md, research/knowledge-hub/README.md</read_first>
  <action>Write a durable coexistence note that explains when to use GSD, when to enter AITP, and how code-backed research should still stay topic-governed. Link it from the root and kernel READMEs and lock those links with a test.</action>
  <verify>python -m pytest research/knowledge-hub/tests/test_agent_bootstrap_assets.py -q</verify>
  <acceptance_criteria>
    - docs/AITP_GSD_WORKFLOW_CONTRACT.md exists
    - root and kernel README link to the workflow contract
  </acceptance_criteria>
  <done>The AITP/GSD coexistence rule is explicit, documented, and tested.</done>
</task>
</tasks>

<verification>
- [ ] `python -m pytest research/knowledge-hub/tests/test_agent_bootstrap_assets.py -q`
</verification>

<success_criteria>
- All tasks completed
- All verification checks pass
- AITP and GSD everyday routing is explicit
</success_criteria>

<output>
After completion, create `.planning/phases/05-aitp-x-gsd-workflow-contract/05-01-SUMMARY.md`
</output>
