chore(copilot): scaffold repo instructions (#370)

* feat(copilot): add baseline chat modes, prompts, and repo-specific instructions

Co-authored-by: wax911 <[email protected]>

* chore: update CONTRIBUTING.md

Co-authored-by: Copilot <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: wax911 <[email protected]>
Co-authored-by: Maxwell Mapako <[email protected]>
Co-authored-by: Copilot <[email protected]>

Author: 3 people

.github/instructions/context.instructions.md

@@ -0,0 +1,90 @@
+---
+applyTo: **
+description: This file describes the architecture and structure of the AniTrend support-markdown library project.
+---
+
+# Support Markdown Library Overview
+
+The **support-markdown** library is an Android markdown parsing library that follows the [AniList markdown specification](https://files.kiniro.uk/anilist-flavored-markdown-v1.md) and is powered by [Markwon](https://noties.github.io/Markwon/).
+
+## Project Structure
+
+This is a multi-module Android library project with the following structure:
+
+### Core Modules
+- **`:app`** - Sample application demonstrating the library usage with UI components
+- **`:markdown`** - Core library module containing the markdown parsing logic and utilities
+- **`:buildSrc`** - Build configuration and shared build logic for all modules
+
+### Key Components
+
+#### Markdown Module (`:markdown`)
+The main library module that provides:
+- Markdown parsing functionality using Markwon
+- AniList-flavored markdown support
+- Integration with Android UI components
+- Image loading support via Coil
+- Link handling with BetterLinkMovementMethod
+
+#### App Module (`:app`) 
+The sample application that demonstrates:
+- How to integrate the markdown library
+- Text rendering with markdown support
+- Image loading in markdown content
+- Link interaction handling
+
+#### BuildSrc Module (`:buildSrc`)
+Contains centralized build configuration:
+- Gradle plugin configurations
+- Dependency management strategies
+- Android build options and configurations
+- Publishing setup for JitPack distribution
+
+## Architecture Patterns
+
+The library follows standard Android library patterns:
+- **Modular design** - Separation between library code and sample app
+- **Gradle-based build system** - Using Kotlin DSL for build configuration
+- **Publishing support** - Configured for JitPack distribution
+- **Testing support** - Unit tests and Android instrumentation tests
+
+## Key Technologies
+
+- **Markwon** - Core markdown rendering engine
+- **Coil** - Image loading for markdown images
+- **BetterLinkMovementMethod** - Enhanced link handling
+- **Android SDK** - Target platform with minimum SDK 21
+- **Kotlin** - Primary programming language
+- **Gradle** - Build system with Kotlin DSL
+
+## Distribution
+
+The library is distributed via JitPack, allowing easy integration:
+```gradle
+allprojects {
+    repositories {
+        maven { url 'https://www.jitpack.io' }
+    }
+}
+
+dependencies {
+    implementation 'com.github.anitrend:support-markdown:{latest_version}'
+}
+```
+
+## Documentation
+
+Full API documentation is available at: https://anitrend.github.io/support-markdown/
+
+## Commit Conventions
+
+The project uses conventional commits with generic scopes:
+- `feat:` - New features
+- `fix:` - Bug fixes  
+- `docs:` - Documentation changes
+- `style:` - Code style changes
+- `refactor:` - Code refactoring
+- `test:` - Test additions/changes
+- `chore:` - Build/tooling changes
+
+Scopes should be kept generic and focus on the type of change rather than specific modules.

CONTRIBUTING.md

@@ -63,5 +63,23 @@ This Code of Conduct is adapted from the [Contributor Covenant][homepage], versi
 [homepage]: http://contributor-covenant.org
 [version]: http://contributor-covenant.org/version/1/4/
 
+## GitHub Copilot customization
+
+This repository includes customizations for GitHub Copilot to improve development experience:
+
+### Chat modes and prompts
+- **Chat modes** are available under `.github/chatmodes/` and provide specialized AI assistance for different development tasks
+- **Prompts** are located in `.github/prompts/` and offer reusable templates for common tasks
+- Use the **conventional commit prompt** (`/conventional-commit`) to generate properly formatted commit messages following our convention
+- When using conventional commits, keep scopes generic. For example, use scopes like `core`, `api`, or `docs` (e.g., `feat(core): ...`, `fix(api): ...`) rather than module-specific scopes such as `parser`, `markdown-renderer`, or `file-uploader` (e.g., `feat(parser): ...`). This helps keep commit history organized and easier to understand.
+
+### Repository-specific instructions
+- Instructions under `.github/instructions/` help Copilot Chat understand the project context and architecture
+- These provide contextual information about the support-markdown library structure and patterns
+- The instructions influence Copilot responses to be more relevant to this specific codebase
+
+### Documentation
+- Full API documentation is available at: https://anitrend.github.io/support-markdown/
+- Refer to the documentation when working with the library's public APIs
 
 Thank you for your contribution!