atdd 0.2.5__py3-none-any.whl → 0.2.7__py3-none-any.whl

atdd/coach/templates/ATDD.md

@@ -4,20 +4,41 @@ missions:
   validate_phase_transitions: "Phase transitions and quality gates per conventions and schemas"
   required: true
 
-# ATDD Gate (REQUIRED before any work)
-# =====================================
-# Before starting ANY task, you MUST confirm you have loaded these rules.
-# Provide this confirmation at the start of your first response:
+# =============================================================================
+# ATDD AGENT BOOTSTRAP PROTOCOL (REQUIRED)
+# =============================================================================
 #
-#   ## ATDD Gate Confirmation
-#   - **File loaded:** CLAUDE.md (or AGENTS.md, etc.)
-#   - **Key constraints:**
-#     1. No ad-hoc tests - follow ATDD conventions
-#     2. Domain layer NEVER imports from other layers
-#     3. Phase transitions require quality gates
+# Problem: Agents often skip instruction files and work without ATDD context.
+# Solution: Coercive context - inject rules via mandatory tool output.
 #
-# If you cannot provide this confirmation, STOP and reload the rules.
-# Run `atdd gate` to verify the expected values.
+# PROTOCOL:
+# ---------
+# 1. Run this command FIRST:
+#
+#    atdd gate
+#
+# 2. Paste the output and confirm:
+#    - Which file(s) were loaded
+#    - The reported hash
+#    - The key ATDD constraints
+#
+# 3. If output shows missing/unsynced files, run:
+#
+#    atdd sync
+#
+#    Then re-run: atdd gate
+#
+# WHY THIS WORKS:
+# - Gate output is mandatory tool output - agent can't ignore it
+# - Proves which ATDD files were actually loaded
+# - Forces consistency across all agents
+#
+# FAILURE MODE:
+# - If agent skips the gate: STOP and run atdd gate again
+# - Don't proceed until gate confirmation is posted
+#
+# RULE: If ATDD rules matter, start with `atdd gate`. No gate = no guarantees.
+# =============================================================================
 
 manifest:
   - trains: "plan/_trains.yaml"

{atdd-0.2.5.dist-info → atdd-0.2.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atdd
-Version: 0.2.5
+Version: 0.2.7
 Summary: ATDD Platform - Acceptance Test Driven Development toolkit
 License: MIT
 Requires-Python: >=3.10
@@ -41,22 +41,15 @@ atdd --help
 ## Quick Start
 
 ```bash
-# Initialize ATDD in your project
-atdd init
-
-# Create a planning session
-atdd session new my-feature
-
-# List sessions
-atdd session list
-
-# Sync ATDD rules to agent config files
-atdd sync
-
-# Run validators
-atdd --test all
+atdd init                      # Initialize ATDD in your project
+atdd gate                      # ⚠️ START EVERY SESSION WITH THIS
+atdd session new my-feature    # Create a planning session
+atdd sync                      # Sync rules to agent config files
+atdd --test all                # Run validators
 ```
 
+> **⚠️ `atdd gate` is required.** Agents skip instruction files but can't ignore tool output. No gate = no ATDD guarantees.
+
 ## What It Does
 
 ATDD provides:
@@ -144,16 +137,29 @@ sync:
 atdd sync  # Creates/updates CLAUDE.md, AGENTS.md, GEMINI.md, QWEN.md
 ```
 
-### ATDD Gate
+### ATDD Gate (Bootstrap Protocol)
 
-Verify agents have loaded ATDD rules before starting work:
+Agents often skip instruction files. The gate solves this by injecting rules via mandatory tool output.
 
-```bash
-atdd gate                  # Show gate verification info
-atdd gate --json           # Output as JSON for programmatic use
-```
+**Protocol:**
+
+1. Run this command first:
+   ```bash
+   atdd gate
+   ```
+
+2. Agent must paste output and confirm:
+   - Which file(s) were loaded
+   - The reported hash
+   - The key constraints
 
-Example output:
+3. If files are missing/unsynced:
+   ```bash
+   atdd sync
+   atdd gate  # Re-verify
+   ```
+
+**Example output:**
 ```
 ============================================================
 ATDD Gate Verification
@@ -172,9 +178,12 @@ Before starting work, confirm you have loaded these rules.
 ------------------------------------------------------------
 ```
 
-Agents should confirm at the start of each session:
-- Which ATDD file(s) they loaded
-- The key constraints they will follow
+**Why this works:**
+- Gate output is mandatory tool output - agent can't ignore it
+- Proves which ATDD files were actually loaded
+- Forces consistency across all agents
+
+**Rule:** If ATDD rules matter, start with `atdd gate`. No gate = no guarantees.
 
 ### Validation
 

{atdd-0.2.5.dist-info → atdd-0.2.7.dist-info}/RECORD

@@ -27,7 +27,7 @@ atdd/coach/overlays/__init__.py,sha256=2lMiMSgfLJ3YHLpbzNI5B88AdQxiMEwjIfsWWb8t3
 atdd/coach/overlays/claude.md,sha256=33mhpqhmsRhCtdWlU7cMXAJDsaVra9uBBK8URV8OtQA,101
 atdd/coach/schemas/config.schema.json,sha256=xzct7gBoPTIGh3NFPSGtfW0zIiyFdHDZkvjuy1qgAqA,951
 atdd/coach/schemas/manifest.schema.json,sha256=WO13-YF_FgH1awh96khCtk-112b6XSC24anlY3B7GjY,2885
-atdd/coach/templates/ATDD.md,sha256=oHZi7g-quHSmE4NPhN20AFSPrB2N03lzeuldX3LG8Xk,11410
+atdd/coach/templates/ATDD.md,sha256=uoLt3gSUym4hd0S5joaTVqmrfbMASn6jhTwrvDSBlhI,11920
 atdd/coach/templates/SESSION-TEMPLATE.md,sha256=p_AwdV9ktKS-FGcg8ocDso74NdR7yeMEQO3dJmeb4VQ,8647
 atdd/coach/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atdd/coach/utils/graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -178,9 +178,9 @@ atdd/tester/validators/test_red_supabase_layer_structure.py,sha256=26cnzPZAwSFy0
 atdd/tester/validators/test_telemetry_structure.py,sha256=hIUnU2WU-8PNIg9EVHe2fnUdIQKIOUm5AWEtCBUXLVk,22467
 atdd/tester/validators/test_typescript_test_naming.py,sha256=E-TyGv_GVlTfsbyuxrtv9sOWSZS_QcpH6rrJFbWoeeU,11280
 atdd/tester/validators/test_typescript_test_structure.py,sha256=eV89SD1RaKtchBZupqhnJmaruoROosf3LwB4Fwe4UJI,2612
-atdd-0.2.5.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-atdd-0.2.5.dist-info/METADATA,sha256=YLszhSnmQooMD3eaLzcg4p1NI6bABS9FBdPz7gAjr_U,6390
-atdd-0.2.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-atdd-0.2.5.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
-atdd-0.2.5.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
-atdd-0.2.5.dist-info/RECORD,,
+atdd-0.2.7.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+atdd-0.2.7.dist-info/METADATA,sha256=xWWAOx07EP3to0A2iMt-KYjp7S5fzrM9SNpt1wZ6gqA,6954
+atdd-0.2.7.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+atdd-0.2.7.dist-info/entry_points.txt,sha256=-C3yrA1WQQfN3iuGmSzPapA5cKVBEYU5Q1HUffSJTbY,38
+atdd-0.2.7.dist-info/top_level.txt,sha256=VKkf6Uiyrm4RS6ULCGM-v8AzYN8K2yg8SMqwJLoO-xs,5
+atdd-0.2.7.dist-info/RECORD,,