[SD-32] Add AI rules generation script and Makefile target

[dudarev]

Summary

• generate AI assistant rule files from master docs/ai/AI-rules.md
• add Makefile command generate-ai-rules
• produce AGENTS.md, CLAUDE.md, .cursorrules

Testing

• make ai-rules
• make ci (fails: pytest complains about coverage arguments)

---

https://chatgpt.com/codex/tasks/task_e_68498ff9d6a8832fb280f2fd5e0aabe8

[linear]

SD-32 Implement GitHub Copilot rule configuration

Implement repository-specific rule configuration for GitHub Copilot based on the research findings from SD-12.

Reference: Research document docs/research/2025-06-03-copilot-jules-claude-rules.md

Deliverables:

• Create .github/copilot-instructions.md based on master docs/ai/AI-rules.md file
• Include DDD architecture rules from ADR 008
• Add testing requirements from ADR 004
• Include security guidelines and coding standards
• Test with Copilot Chat to validate rule effectiveness

Acceptance Criteria:

• .github/copilot-instructions.md file created and committed
• Content derived from master docs/ai/AI-rules.md file (following implementation plan from SD-12 research)
• Rules reference SpeechDown's DDD architecture (domain/application/infrastructure layers)
• Include naming conventions (interfaces end in Port, implementations in Adapter)
• Specify testing requirements (pytest, unit tests required)
• Include security guidelines (no secrets, PEP8 compliance)
• Manual testing confirms Copilot Chat follows the guidelines
• File is properly formatted markdown and passes CI checks

Implementation Notes:
Based on research, GitHub Copilot automatically incorporates instructions from .github/copilot-instructions.md into all Copilot Chat responses for the repository. This file should be generated from or based on the master AI rules file as outlined in the SD-12 implementation plan.

[Copilot]

Pull Request Overview

This PR adds tooling to generate AI assistant–specific rule files from a single master Markdown document, integrates the new command into the build, and aligns Python version requirements across configs.

• Introduce scripts/generate_ai_rules.py for filtering docs/ai/AI-rules.md into Copilot, Cursor, Claude, and Agents files.
• Add an ai-rules Makefile target and update CI targets to include FFmpeg installation and Python 3.11.
• Synchronize Python version (>=3.11) in pyproject.toml, docs, and GitHub Actions.

Reviewed Changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
scripts/generate_ai_rules.py	New script to parse and split master AI rules by target.
pyproject.toml	Downgraded requires-python to >=3.11; separated testing deps into testing and testing-local.
docs/research/2025-06-03-copilot-jules-claude-rules.md	Updated Python version note to 3.11.
docs/ai/AI-rules.md	Added master AI rules with maintainer note and markers.
docs/adrs/current/003_standardized_adr_prompt.md	Added “Related ADRs” link.
docs/adrs/current/001_adrs_process.md	Added “Related ADRs” link.
Makefile	Expanded .PHONY, added ai-rules target, adjusted test/CI targets.
.github/workflows/ci.yml	Changed GitHub Actions Python version to 3.11; added FFmpeg install.
.github/copilot-instructions.md	Generated Copilot rules file.
CLAUDE.md	Generated Claude rules file.
AGENTS.md	Generated general agents rules file.
.cursorrules	Generated Cursor rules file.

Comments suppressed due to low confidence (3)

scripts/generate_ai_rules.py:11

• Consider adding unit tests for filter_content_for_target and the main function to verify that each target (copilot, cursor, remote, claude) produces the expected output files.

def filter_content_for_target(content: str, target: str) -> str:

Makefile:94

• [nitpick] Please update the project README or contributing guide to document the new make ai-rules target so contributors know how to regenerate AI assistant rules.

ai-rules:

Makefile:94

• [nitpick] The PR description refers to a generate-ai-rules command, but the Makefile target is named ai-rules. Consider aligning these names for consistency.

ai-rules: