Add comprehensive AI assistant guidelines and ADR management system

[newhoggy]

Changes

This PR adds comprehensive AI assistant guidelines and tooling for the cardano-cli project:

• Added: .github/copilot-instructions.md - Complete AI coding assistant guidelines (197 lines)
• Added: scripts/wiki-update - Automated ADR documentation management script (52 lines)
• Modified: .gitignore - Added exclusions for .ai-scratch/ and docs/mirror/ directories

Changelog

- description: |
    Add comprehensive AI assistant guidelines and ADR management system for cardano-cli development
# uncomment types applicable to the change:
  type:
  # - feature        # introduces a new feature
  # - breaking       # the API has changed in a breaking way
  # - compatible     # the API has changed but is non-breaking
  # - optimisation   # measurable performance improvements
  # - refactoring    # QoL changes
  # - bugfix         # fixes a defect
  # - test           # fixes/modifies tests
  # - maintenance    # not directly related to the code
  # - release        # related to a new release preparation
  - documentation  # change in code docs, haddocks...

Context

This PR introduces a comprehensive framework for AI coding assistants working on the cardano-cli project. The goal is to provide AI assistants with detailed architectural guidance, development patterns, and best practices specific to this codebase.

The framework includes:

• Architectural Documentation: Complete overview of era-based command structure, module organization, and type-safe era handling patterns
• Development Workflows: Standardized procedures for building, testing, package management, and CI/HLS considerations
• ADR Integration: Local mirror system for Architecture Decision Records with automatic freshness checking
• AI-Specific Guidelines: Detailed instructions for CLI usage patterns, era preferences, output design, git workflows, and file organization
• Documentation Management: Automated wiki synchronization system for keeping ADRs up-to-date

This addresses the need for AI assistants to understand cardano-cli's unique architectural patterns, especially the era-based command system and the project's formal decision-making process through ADRs.

How to trust this PR

Key files to review:

1. .github/copilot-instructions.md - The main AI guidelines document covering:

   • Era-based architecture patterns and module organization
   • Development workflows and testing conventions using tasty-discover and Hedgehog
   • CLI help reference system using golden test files
   • Local ADR integration with automatic freshness monitoring
   • AI-specific usage guidelines for era handling, git commands, and file organization

2. scripts/wiki-update - ADR management automation that:

   • Clones/updates cardano-node-wiki to docs/mirror/cardano-node-wiki
   • Handles conflicts by discarding local changes and resetting to remote main
   • Tracks update timestamps in docs/mirror/dates/cardano-node-wiki
   • Creates directory structure automatically

3. .gitignore - Excludes new directories:

   • .ai-scratch/ for temporary AI-generated files (commit messages, analysis outputs)
   • docs/mirror/ for local documentation mirrors

Testing the wiki-update script:

# Test the ADR management system
./scripts/wiki-update

# Verify ADRs are available locally
ls docs/mirror/cardano-node-wiki/docs/ADR-*.md

# Check update timestamp
cat docs/mirror/dates/cardano-node-wiki

# Test update functionality (run again)
./scripts/wiki-update

Verifying AI guidelines:

The guidelines reference concrete project patterns and can be validated by checking:

• Golden test files in cardano-cli/test/cardano-cli-golden/files/golden/help/
• Era-specific commands in src/Cardano/CLI/EraBased/
• ADR documents for architectural decisions (once mirrored locally)
• Project-specific conventions for language extensions and error handling

Checklist

• Commit sequence broadly makes sense and commits have useful messages
• New tests are added if needed and existing tests are updated. See Running tests for more details
• Self-reviewed the diff

[github-actions]

This PR is stale because it has been open 45 days with no activity.