Skip to content

Revise AI rules and extend editor support to Claude, Copilot, and Antigravity - #798

Merged
tjementum merged 9 commits into
mainfrom
pp-644-update-ai-rules-and-workflows
Nov 29, 2025
Merged

Revise AI rules and extend editor support to Claude, Copilot, and Antigravity#798
tjementum merged 9 commits into
mainfrom
pp-644-update-ai-rules-and-workflows

Conversation

@tjementum

Copy link
Copy Markdown
Member

Summary & Motivation

Restructure and consolidate AI rules to establish .claude as the source of truth, with automatic synchronization to Cursor, Windsurf, GitHub Copilot, and Google Antigravity editors. This change improves maintainability by having a single canonical location for all AI rules while ensuring compatibility across different AI-assisted development tools.

  • Review all AI rules and ensure they follow the latest practice
  • Reorganize all rules into the .claude/rules/** and .claude/commands/**
  • Consolidate main AI rules into AGENTS.md for Windsurf, Cursor, Antigravity compatibility
    Use a symbolic link to have CLAUDE.md and .github/copilot-instructions.md contain the same content as AGENTS.md
  • Add workflow files for implementing tasks, reviewing code, creating PRDs, and end-to-end test processes
  • Create mapping support for product management tools (Linear, Azure DevOps, Jira)
  • Implement sync-ai-rules CLI command that synchronizes rules from .claude to .cursor, .windsurf, .agents, and .github/copilot
  • Refactor commit workflow with streamlined process and relocate to commands root

Downstream projects

  1. Update AGENTS.md
  • Change [CLI_ALIAS]="pp" to your Developer CLI alias
  • Change PRODUCT_MANAGEMENT_TOOL="Linear" to your product management tool. Possible values are AzureDevOps, Jira, and Linear. This requires you to have an MCP server for this tool. Use Markdown to use local file system.
  1. If custom rules or adjustments were made migrate them to .claude/rules and .claude/workflows. And then run the [CLI_ALIAS] sync-ai-rules

Checklist

  • I have added tests, or done manual regression tests
  • I have updated the documentation, if necessary

@tjementum tjementum self-assigned this Nov 29, 2025
@tjementum
tjementum requested a review from a team as a code owner November 29, 2025 22:49
@tjementum tjementum added the Enhancement New feature or request label Nov 29, 2025
@linear

linear Bot commented Nov 29, 2025

Copy link
Copy Markdown

@tjementum tjementum moved this to 🏗 In Progress in Kanban board Nov 29, 2025
@tjementum
tjementum force-pushed the pp-644-update-ai-rules-and-workflows branch from 8e572c2 to f4fe336 Compare November 29, 2025 22:53
@tjementum
tjementum merged commit 8ec121f into main Nov 29, 2025
2 checks passed
@tjementum
tjementum deleted the pp-644-update-ai-rules-and-workflows branch November 29, 2025 22:57
@github-project-automation github-project-automation Bot moved this from 🏗 In Progress to ✅ Done in Kanban board Nov 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Enhancement New feature or request

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

1 participant