Move specs/ to scratchpad/ and update references

.github/agents/agentic-campaign-designer.agent.md

@@ -262,7 +262,7 @@ gh aw campaign validate <campaign-id>
 Point users to these resources:
 - **Getting started**: https://githubnext.github.io/gh-aw/guides/campaigns/getting-started/
 - **Campaign flow**: https://githubnext.github.io/gh-aw/guides/campaigns/flow/
-- **Spec format**: https://githubnext.github.io/gh-aw/guides/campaigns/specs/
+- **Spec format**: https://githubnext.github.io/gh-aw/guides/campaigns/scratchpad/
 - **Workflow catalog**: https://github.com/githubnext/agentics
 
 ## Success Criteria

.github/agents/developer.instructions.md

@@ -105,7 +105,7 @@ graph TD
 - **Large (500-1000 lines)**: Complex features, comprehensive implementations
 - **Very Large (1000+ lines)**: Consider splitting if not cohesive
 
-**Implementation**: See specs/code-organization.md for complete guidelines
+**Implementation**: See scratchpad/code-organization.md for complete guidelines
 
 ---
 
@@ -183,7 +183,7 @@ graph TD
     F -->|Other| I[Create New Domain File]
 ```
 
-**Implementation**: See specs/validation-architecture.md for complete architecture
+**Implementation**: See scratchpad/validation-architecture.md for complete architecture
 
 ---
 
@@ -208,7 +208,7 @@ graph TD
 - **File Names**: Use lowercase with hyphens (e.g., `code-organization.md`)
 - **Code Elements**: Follow language conventions (e.g., `camelCase` in JavaScript, `snake_case` in Python)
 
-**Implementation**: See specs/capitalization.md and `cmd/gh-aw/capitalization_test.go`
+**Implementation**: See scratchpad/capitalization.md and `cmd/gh-aw/capitalization_test.go`
 
 ### Breaking Change Rules
 
@@ -235,7 +235,7 @@ graph TD
 - Internal refactoring with same external behavior
 - Adding new features that don't affect existing functionality
 
-**Implementation**: See specs/breaking-cli-rules.md for complete rules
+**Implementation**: See scratchpad/breaking-cli-rules.md for complete rules
 
 ---
 
@@ -271,7 +271,7 @@ graph TD
 - `normalizeLineEndings()` - Converts CRLF to LF
 - `normalizeMarkdown()` - Standardizes markdown formatting
 
-**Implementation**: See specs/string-sanitization-normalization.md and `pkg/workflow/strings.go`
+**Implementation**: See scratchpad/string-sanitization-normalization.md and `pkg/workflow/strings.go`
 
 ---
 
@@ -301,7 +301,7 @@ err := yaml.Unmarshal(data, &workflow)
 - Boolean values: `yes`, `no`, `true`, `false`, `on`, `off`
 - Null values: `null`, `~`
 
-**Implementation**: See specs/yaml-version-gotchas.md and `pkg/workflow/compiler.go`
+**Implementation**: See scratchpad/yaml-version-gotchas.md and `pkg/workflow/compiler.go`
 
 ---
 
@@ -337,7 +337,7 @@ safe_outputs:
       > AI generated by [WorkflowName](run_url)
 ```
 
-**Implementation**: See specs/safe-output-messages.md and `pkg/workflow/safe_outputs.go`
+**Implementation**: See scratchpad/safe-output-messages.md and `pkg/workflow/safe_outputs.go`
 
 ---
 
@@ -373,7 +373,7 @@ actions/
     └── sh/
 ```
 
-**Implementation**: See specs/actions.md and `pkg/cli/actions_build_command.go`
+**Implementation**: See scratchpad/actions.md and `pkg/cli/actions_build_command.go`
 
 ---
 
@@ -417,7 +417,7 @@ steps:
   - uses: actions/checkout@a1b2c3d4... # Pinned SHA
 ```
 
-**Implementation**: See specs/github-actions-security-best-practices.md and specs/template-injection-prevention.md
+**Implementation**: See scratchpad/github-actions-security-best-practices.md and scratchpad/template-injection-prevention.md
 
 ---
 
@@ -485,7 +485,7 @@ make update-golden
 - ❌ Tests fail unexpectedly during development
 - ❌ Making unrelated code changes
 
-**Implementation**: See specs/visual-regression-testing.md and `pkg/console/golden_test.go`
+**Implementation**: See scratchpad/visual-regression-testing.md and `pkg/console/golden_test.go`
 
 ---
 
@@ -543,7 +543,7 @@ repo-memory:
 - Allowed/blocked file patterns
 - Size and count tracking in commit messages
 
-**Implementation**: See specs/repo-memory.md and `pkg/workflow/repo_memory.go`
+**Implementation**: See scratchpad/repo-memory.md and `pkg/workflow/repo_memory.go`
 
 ---
 
@@ -587,7 +587,7 @@ graph TD
 - Proactive maintenance
 - Quality assessment
 
-**Implementation**: See specs/agents/hierarchical-agents.md and `.github/workflows/` meta-orchestrator files
+**Implementation**: See scratchpad/agents/hierarchical-agents.md and `.github/workflows/` meta-orchestrator files
 
 ---
 
@@ -629,7 +629,7 @@ For manual feature testing in pull requests:
 3. Dev Hawk will analyze and verify behavior
 4. Do not merge dev.md changes - it remains a reusable test harness
 
-**Implementation**: See specs/changesets.md and specs/end-to-end-feature-testing.md
+**Implementation**: See scratchpad/changesets.md and scratchpad/end-to-end-feature-testing.md
 
 ---
 
@@ -672,56 +672,56 @@ For manual feature testing in pull requests:
 
 ## Additional Documentation
 
-For detailed specifications, see individual files in `specs/`:
+For detailed specifications, see individual files in `scratchpad/`:
 
 ### Architecture & Organization
-- [Code Organization Patterns](../../specs/code-organization.md)
-- [Validation Architecture](../../specs/validation-architecture.md)
-- [Layout System](../../specs/layout.md)
-- [Go Type Patterns](../../specs/go-type-patterns.md)
+- [Code Organization Patterns](../../scratchpad/code-organization.md)
+- [Validation Architecture](../../scratchpad/validation-architecture.md)
+- [Layout System](../../scratchpad/layout.md)
+- [Go Type Patterns](../../scratchpad/go-type-patterns.md)
 
 ### Core Features
-- [Safe Output Messages Design](../../specs/safe-output-messages.md)
-- [Repo-Memory System](../../specs/repo-memory.md)
-- [MCP Gateway](../../specs/mcp-gateway.md)
-- [MCP Logs Guardrails](../../specs/mcp_logs_guardrails.md)
-- [Custom Actions Build](../../specs/actions.md)
+- [Safe Output Messages Design](../../scratchpad/safe-output-messages.md)
+- [Repo-Memory System](../../scratchpad/repo-memory.md)
+- [MCP Gateway](../../scratchpad/mcp-gateway.md)
+- [MCP Logs Guardrails](../../scratchpad/mcp_logs_guardrails.md)
+- [Custom Actions Build](../../scratchpad/actions.md)
 
 ### Testing & Quality
-- [Testing Framework](../../specs/testing.md)
-- [Visual Regression Testing](../../specs/visual-regression-testing.md)
-- [End-to-End Feature Testing](../../specs/end-to-end-feature-testing.md)
-- [Security Review](../../specs/security_review.md)
-- [GoSec Integration](../../specs/gosec.md)
+- [Testing Framework](../../scratchpad/testing.md)
+- [Visual Regression Testing](../../scratchpad/visual-regression-testing.md)
+- [End-to-End Feature Testing](../../scratchpad/end-to-end-feature-testing.md)
+- [Security Review](../../scratchpad/security_review.md)
+- [GoSec Integration](../../scratchpad/gosec.md)
 
 ### Security & Standards
-- [GitHub Actions Security](../../specs/github-actions-security-best-practices.md)
-- [Template Injection Prevention](../../specs/template-injection-prevention.md)
-- [String Sanitization](../../specs/string-sanitization-normalization.md)
-- [Schema Validation](../../specs/schema-validation.md)
+- [GitHub Actions Security](../../scratchpad/github-actions-security-best-practices.md)
+- [Template Injection Prevention](../../scratchpad/template-injection-prevention.md)
+- [String Sanitization](../../scratchpad/string-sanitization-normalization.md)
+- [Schema Validation](../../scratchpad/schema-validation.md)
 
 ### Development Guidelines
-- [Capitalization Guidelines](../../specs/capitalization.md)
-- [Breaking Change Rules](../../specs/breaking-cli-rules.md)
-- [CLI Command Patterns](../../specs/cli-command-patterns.md)
-- [Styles Guide](../../specs/styles-guide.md)
-- [Changesets](../../specs/changesets.md)
-- [Labels](../../specs/labels.md)
+- [Capitalization Guidelines](../../scratchpad/capitalization.md)
+- [Breaking Change Rules](../../scratchpad/breaking-cli-rules.md)
+- [CLI Command Patterns](../../scratchpad/cli-command-patterns.md)
+- [Styles Guide](../../scratchpad/styles-guide.md)
+- [Changesets](../../scratchpad/changesets.md)
+- [Labels](../../scratchpad/labels.md)
 
 ### Advanced Topics
-- [Hierarchical Agents](../../specs/agents/hierarchical-agents.md)
-- [Hierarchical Agents Quickstart](../../specs/agents/hierarchical-agents-quickstart.md)
-- [Gastown Multi-Agent Orchestration](../../specs/gastown.md)
-- [mdflow Comparison](../../specs/mdflow-comparison.md)
-- [mdflow Deep Research](../../specs/mdflow.md)
+- [Hierarchical Agents](../../scratchpad/agents/hierarchical-agents.md)
+- [Hierarchical Agents Quickstart](../../scratchpad/agents/hierarchical-agents-quickstart.md)
+- [Gastown Multi-Agent Orchestration](../../scratchpad/gastown.md)
+- [mdflow Comparison](../../scratchpad/mdflow-comparison.md)
+- [mdflow Deep Research](../../scratchpad/mdflow.md)
 
 ### Technical Details
-- [YAML Version Gotchas](../../specs/yaml-version-gotchas.md)
-- [Validation Refactoring](../../specs/validation-refactoring.md)
-- [Workflow Refactoring Patterns](../../specs/workflow-refactoring-patterns.md)
-- [Safe Output Handlers Refactoring](../../specs/safe-output-handlers-refactoring.md)
-- [Artifact Naming Compatibility](../../specs/artifact-naming-compatibility.md)
-- [Safe Output Environment Variables](../../specs/safe-output-environment-variables.md)
+- [YAML Version Gotchas](../../scratchpad/yaml-version-gotchas.md)
+- [Validation Refactoring](../../scratchpad/validation-refactoring.md)
+- [Workflow Refactoring Patterns](../../scratchpad/workflow-refactoring-patterns.md)
+- [Safe Output Handlers Refactoring](../../scratchpad/safe-output-handlers-refactoring.md)
+- [Artifact Naming Compatibility](../../scratchpad/artifact-naming-compatibility.md)
+- [Safe Output Environment Variables](../../scratchpad/safe-output-environment-variables.md)
 
 ---
 

.github/aw/generate-agentic-campaign.md

@@ -94,7 +94,7 @@ Use `update_issue` with `operation: "append"` so you **do not overwrite** the or
 Docs to link:
 - Getting started: https://githubnext.github.io/gh-aw/guides/campaigns/getting-started/
 - Flow & lifecycle: https://githubnext.github.io/gh-aw/guides/campaigns/flow/
-- Campaign specs: https://githubnext.github.io/gh-aw/guides/campaigns/specs/
+- Campaign specs: https://githubnext.github.io/gh-aw/guides/campaigns/scratchpad/
 
 ### Required structure for the issue update
 

.github/workflows/breaking-change-checker.md

@@ -49,7 +49,7 @@ You are a code reviewer specialized in identifying breaking CLI changes. Analyze
 First, read and understand the breaking change rules defined in the spec:
 
 ```bash
-cat ${{ github.workspace }}/specs/breaking-cli-rules.md
+cat ${{ github.workspace }}/scratchpad/breaking-cli-rules.md
 ```
 
 Key breaking change categories:
@@ -171,14 +171,14 @@ List the commits that were analyzed with their details.
 Complete the following items to address these breaking changes:
 
 - [ ] **Review all breaking changes detected** - Verify each change is correctly categorized
-- [ ] **Create a changeset file in `.changeset/` directory** - Create a file like `major-breaking-change-description.md` with the change details. Specify the semver bump type (`major`, `minor`, or `patch`) in the YAML frontmatter of the changeset file. The release script determines the overall version bump by selecting the highest-priority bump type across all changesets. See [specs/changesets.md](specs/changesets.md) for format details.
+- [ ] **Create a changeset file in `.changeset/` directory** - Create a file like `major-breaking-change-description.md` with the change details. Specify the semver bump type (`major`, `minor`, or `patch`) in the YAML frontmatter of the changeset file. The release script determines the overall version bump by selecting the highest-priority bump type across all changesets. See [scratchpad/changesets.md](scratchpad/changesets.md) for format details.
 - [ ] **Add migration guidance to changeset** - Include clear migration instructions in the changeset file showing users how to update their workflows
 - [ ] **Document breaking changes in CHANGELOG.md** - Add entries under "Breaking Changes" section with user-facing descriptions
 - [ ] **Verify backward compatibility was considered** - Confirm that alternatives to breaking were evaluated
 
 ### Reference
 
-See [specs/breaking-cli-rules.md](specs/breaking-cli-rules.md) for the complete breaking change policy.
+See [scratchpad/breaking-cli-rules.md](scratchpad/breaking-cli-rules.md) for the complete breaking change policy.
 
 ---
 

.github/workflows/copilot-agent-analysis.md

@@ -261,7 +261,7 @@ If the history file doesn't exist or has gaps in the data, rebuild it by queryin
 
 #### 4.2 Store Today's Metrics
 
-Store today's metrics (see standardized metric names in specs/metrics-glossary.md):
+Store today's metrics (see standardized metric names in scratchpad/metrics-glossary.md):
 - Total PRs created today (`agent_prs_total`)
 - Number merged/closed/open (`agent_prs_merged`)
 - Average comments per PR
@@ -295,7 +295,7 @@ Store the data in JSON format with proper structure.
 repo:${{ github.repository }} is:pr "START COPILOT CODING AGENT" created:YYYY-MM-DD..YYYY-MM-DD
 ```
 
-Or use `list_pull_requests` with date filtering and filter results by agent criteria (see `agent_prs_total` in specs/metrics-glossary.md for scope).
+Or use `list_pull_requests` with date filtering and filter results by agent criteria (see `agent_prs_total` in scratchpad/metrics-glossary.md for scope).
 
 **Process:**
 - Start with the oldest missing date in your target range (maximum 3 days ago)
@@ -315,7 +315,7 @@ Or use `list_pull_requests` with date filtering and filter results by agent crit
 
 #### 4.3 Store Today's Metrics
 
-After ensuring historical data is available (either from existing repo memory or rebuilt), add today's metrics (see specs/metrics-glossary.md):
+After ensuring historical data is available (either from existing repo memory or rebuilt), add today's metrics (see scratchpad/metrics-glossary.md):
 - Total PRs created today (`agent_prs_total`)
 - Number merged/closed/open (`agent_prs_merged`, `closed_prs`, `open_prs`)
 - Average comments per PR

.github/workflows/daily-code-metrics.md

@@ -45,7 +45,7 @@ Analyze codebase daily: compute size, quality, health metrics. Track 7/30-day tr
 
 ## Metrics to Collect
 
-All metrics use standardized names from specs/metrics-glossary.md:
+All metrics use standardized names from scratchpad/metrics-glossary.md:
 
 **Size**: LOC by language (`lines_of_code_total`), by directory (cmd, pkg, docs, workflows), file counts/distribution