docs(skills): Document squash-only merge requirement

[cursor]

Summary

The repository only allows squash merges, but this is not documented in the skill documentation or agent instructions.

Issue Encountered

When attempting to enable auto-merge with --merge:

gh pr merge 625 --auto --merge --delete-branch
# Error: Merge method merge commits are not allowed on this repository

Had to retry with --squash:

gh pr merge 625 --auto --squash --delete-branch
# Success

Impact

• Agents waste tokens on failed merge attempts
• Skills like Merge-PR.ps1 default to merge strategy

Suggested Fixes

1. Update Merge-PR.ps1 default: Change default strategy from "merge" to "squash"
2. Add documentation: Note in AGENTS.md that squash is the only allowed merge method
3. Add skill memory: Create Serena memory documenting this constraint

Files to Update

• .claude/skills/github/scripts/pr/Merge-PR.ps1 - Change default
• AGENTS.md - Add merge policy documentation
• .serena/memories/github-merge-policy.md - Create new memory

[github-actions]

AI Triage Summary

Note

This issue has been automatically triaged by AI agents

What is AI Triage?

This issue was analyzed by AI agents:

• Analyst Agent: Categorizes the issue and suggests appropriate labels
• Roadmap Agent: Aligns the issue with project milestones and priorities
• Explainer Agent (if escalated): Generates comprehensive PRD

Triage Results

Property	Value
Category	documentation
Labels	["documentation","area-prompts"]
Priority	P2
Milestone	v1.1

Categorization Analysis

```json
{
  "labels": ["documentation", "area-prompts"],
  "category": "documentation",
  "confidence": 0.85,
  "reasoning": "Issue requests documentation of squash-only merge requirement in skills and agent instructions, with suggested updates to scripts and memory files"
}

</details>

<details>
<summary>Roadmap Alignment</summary>

```json
Based on my analysis:

**Issue Type**: Documentation + bug fix (updating defaults and adding documentation about merge policy)

**KANO Classification**: Must-Be - Users expect merge commands to work correctly without trial and error.

**Impact Assessment**:
- Scope: 3 files, single concern (merge policy)
- Dependencies: None - internal documentation change
- Uncertainty: Low - clear path forward
- Stakeholders: Internal agents only

**Complexity Score**: 5 (single file/function scope, no external deps, clear path, internal)

**Roadmap Alignment**: No direct epic alignment. This is a documentation/bug fix task, not a strategic feature. It addresses agent efficiency by reducing token waste on failed merge attempts.

**Priority Determination**:
- Impact: Low (affects agent workflow efficiency, not core functionality)
- Urgency: Can wait (workaround exists: use --squash)
- Priority: P2

**PRD Escalation**: Not warranted
- Not a feature request (bug fix + documentation)
- No research required (solution is clear)
- No external dependencies
- Single PR work
- No architectural impact
- Internal tooling only

```json
{
  "milestone": "v1.1",
  "priority": "P2",
  "epic_alignment": "",
  "confidence": 0.85,
  "reasoning": "Documentation and bug fix for merge policy; clear solution, no PRD needed",
  "escalate_to_prd": false,
  "escalation_criteria": [],
  "complexity_score": 5
}

</details>

---

<sub>Powered by [AI Issue Triage](https://github.com/rjmurillo/ai-agents) workflow</sub>

[coderabbitai]

📝 CodeRabbit Plan Mode

Generate an implementation plan and prompts that you can use with your favorite coding agent.

• Create Plan

Examples

• Example 1
• Example 2

---

🔗 Similar Issues

Related Issues

• feat: Add PR merge state verification to prevent wasted review effort #321
• fix: Add mandatory CI check verification before claiming PR review complete #369
• New Agent: Merge Resolver for intelligent git conflict resolution #198

🔗 Related PRs

#100 - fix(ci): ensure Pester Tests workflow satisfies required checks for all PRs [merged]
#141 - feat(skills): document dorny/paths-filter checkout requirement [merged]
#301 - docs: autonomous PR monitoring prompt and retrospective [merged]
#322 - feat: Implement PR merge state verification to prevent wasted review effort [merged]
#627 - fix(docs): update remaining GitHubHelpers references to GitHubCore [closed]

👤 Suggested Assignees

• rjmurillo-bot

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!