diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
deleted file mode 100644
index 165e2cc..0000000
--- a/.github/copilot-instructions.md
+++ /dev/null
@@ -1,281 +0,0 @@
-# Open Source Bazaar - GitHub Copilot Instructions
-
-Open Source Bazaar is an open-source project showcase platform built with Next.js 15, TypeScript, React Bootstrap, and MobX. It includes license filters, Wiki knowledge base, volunteer showcase, Lark integration, and other features.
-
-Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
-
-## Critical Requirements
-
-⚠️ **MANDATORY NODE.JS VERSION**: This project requires **Node.js >=20**. The build works on Node.js 20+ but may have warnings.
-
-- Check Node.js version: `node --version`
-- Development and linting commands work on Node.js 20+
-- Use **PNPM** as package manager, not NPM or Yarn
-
-## Working Effectively
-
-### Initial Setup (REQUIRED for all development)
-
-1. **Install global pnpm**: `npm install -g pnpm`
-2. **Install dependencies**: `pnpm install` -- takes 1-3 minutes. NEVER CANCEL. Set timeout to 5+ minutes.
-3. **Verify setup**: `pnpm --version` (should be 10.x+)
-
-**Important**: If you see "node_modules missing" error, you MUST run `pnpm install` first before any other commands.
-
-### Development Workflow (FULLY VALIDATED)
-
-- **Start development server**: `pnpm dev` -- starts in 5-15 seconds on http://localhost:3000
-- **Run linting**: `pnpm lint` -- takes 15 seconds. NEVER CANCEL. Set timeout to 2+ minutes.
-- **Run tests**: `pnpm test` -- runs lint-staged + lint, takes 15 seconds. Set timeout to 2+ minutes.
-
-### Build Process
-
-- **Production build**: `pnpm build` -- works on Node.js 20+ (estimated 30s-2 minutes)
- - NEVER CANCEL. Set timeout to 5+ minutes.
-- **Static export**: Available but not commonly used in development
-
-## Validation Scenarios
-
-After making ANY changes, ALWAYS validate by running through these scenarios:
-
-### Manual Testing Requirements
-
-1. **Start development server**: `pnpm dev` and verify it starts without errors
-2. **Navigate to homepage**: Visit http://localhost:3000 and verify page loads with navigation menu
-3. **Test core pages**:
- - License filter: http://localhost:3000/license-filter (interactive license selection tool)
- - Wiki pages: http://localhost:3000/policy (policy documents from GitHub)
- - Volunteer page: http://localhost:3000/volunteer (contributor showcase)
- - Projects: http://localhost:3000/project (GitHub repository listings)
-4. **Test API endpoints**: Verify GitHub API integrations work
-5. **Check responsive design**: Test mobile/desktop layouts with React Bootstrap components
-6. **Verify i18n functionality**: Check Chinese/English language switching works
-
-### Pre-commit Validation
-
-ALWAYS run before committing changes:
-
-```bash
-npm test # Runs linting + staged file checks
-```
-
-## Key Project Structure
-
-### Important Directories
-
-- `pages/` - Next.js pages and API routes
-- `components/` - Reusable React components with Bootstrap styling
-- `models/` - MobX stores and data models
-- `translation/` - i18n language files (zh-CN, en-US, zh-TW)
-- `styles/` - CSS and styling files
-- `public/` - Static assets
-
-### Configuration Files
-
-- `package.json` - Dependencies and scripts
-- `next.config.ts` - Next.js configuration with MDX support
-- `tsconfig.json` - TypeScript configuration
-- `eslint.config.ts` - ESLint configuration
-- `babel.config.js` - Babel configuration
-
-### Key Dependencies
-
-- **Next.js 15** - React framework
-- **React Bootstrap 2.10** - UI component library
-- **MobX 6.13** - State management
-- **MobX-GitHub 0.4** - GitHub API integration
-- **MobX-i18n 0.7** - Internationalization
-- **License-Filter 0.2** - License filtering functionality
-- **Marked 16.2** - Markdown processing
-
-## Development Standards and Best Practices
-
-Based on comprehensive PR review analysis, follow these critical development standards:
-
-### Architecture and Code Organization
-
-#### Component and Import Standards
-
-- **ALWAYS use React Bootstrap components** instead of custom HTML elements
-- Use utilities from established libraries: 'web-utility'
-- Import `'./Base'` in model files for proper configuration
-
-#### Error Handling and Static Generation
-
-- **Natural error throwing** for static generation - let errors bubble up to catch build issues
-- Ensure build passes before pushing - resolve issues at compile time
-
-### UI/UX Standards
-
-#### Component Usage Patterns
-
-```typescript
-// ✅ Correct - use React Bootstrap components
-import { Button, Badge, Breadcrumb, Card, Container } from 'react-bootstrap';
-
-
-
-{label}
-
-// ❌ Wrong - custom HTML elements
-Edit
-{label}
-```
-
-#### Semantic HTML Structure
-
-- Use ordered lists (`
`) for countable items, unordered lists (`
`) for navigation
-- Apply proper semantic structure: ``, ``, ``
-- Use `list-unstyled` class for first-level lists to remove default styling
-
-### Code Quality Standards
-
-#### Modern ECMAScript Features
-
-- Use optional chaining and modern JavaScript features
-- Let TypeScript infer types when possible to avoid verbose annotations
-- Use modern ECMAScript patterns for cleaner, more maintainable code
-
-#### Import and Type Management
-
-- Import from established sources: ContentModel from mobx-github, utilities from web-utility
-- Import configuration files where needed: `'./Base'` for GitHub client setup
-- Use minimal exports and avoid unnecessary custom implementations
-- Use configured clients rather than creating new ones
-
-### Translation and Internationalization
-
-#### Critical Translation Requirements
-
-- **ALL user-facing text** MUST be translated using i18n system
-- This includes button text, labels, error messages, placeholder text, and dynamic content
-- Use the `t()` function from I18nContext for all translations
-
-#### Translation Patterns
-
-- Use the `t()` function from I18nContext for all user-facing text
-- Translate all button text, labels, error messages, and dynamic content
-- Avoid hardcoded text in any language
-
-#### Translation Key Management
-
-- Use generic terms unless specifically scoped: `t('knowledge_base')` not `t('policy_documents')`
-- Add translation keys to ALL language files: `zh-CN.ts`, `en-US.ts`, `zh-TW.ts`
-- Remove unused translation keys when replacing with generic ones
-
-### Data Modeling and Content Management
-
-#### Content Model Patterns
-
-- Use ContentModel with configured client from mobx-github
-- Import configuration via `'./Base'` to ensure proper GitHub client setup
-- Handle Base64 content decoding when processing GitHub API responses
-
-#### Tree Structure and Navigation
-
-- Use `treeFrom` utility from web-utility for hierarchical data structures
-- Follow established patterns for tree node organization and navigation
-
-### GitHub Integration Standards
-
-#### API Usage Patterns
-
-- Import configured `githubClient` from `models/Base.ts`
-
-#### Authentication and Rate Limiting
-
-- GitHub API authentication is configured in `models/Base.ts`
-- Use the configured client to avoid rate limiting and authentication issues
-- Don't create separate GitHub API instances
-
-### Build and Development Process
-
-#### Pre-commit Standards
-
-1. **Run linting**: `pnpm lint` to auto-fix formatting
-2. **Check build**: Ensure `pnpm build` passes
-3. **Validate translations**: Verify all text is properly translated
-4. **Remove unused code**: Clean up unused imports and translation keys
-
-#### Code Review Compliance
-
-- **Follow exact code suggestions** from reviews when provided
-- Use **minimal approach** - only include explicitly requested functionality
-- **Don't add extra features** not specified in requirements
-- **Address reviewer feedback completely** before requesting re-review
-
-## Common Commands Reference
-
-### Package Management
-
-```bash
-pnpm install # Install dependencies (1-3 minutes)
-pnpm --version # Check pnpm version
-```
-
-### Development
-
-```bash
-pnpm dev # Start development server (5-15s)
-pnpm build # Production build (30s-2min)
-pnpm start # Start production server
-```
-
-### Code Quality
-
-```bash
-pnpm lint # Run ESLint with auto-fix (15s)
-pnpm test # Run tests (lint-staged + lint, 15s)
-```
-
-## Troubleshooting
-
-### Common Issues and Solutions
-
-#### Build and Development Issues
-
-- **"Unsupported engine" warnings**: Expected on Node.js <22, development still works
-- **Build hangs**: Never cancel builds - they may take several minutes, set appropriate timeouts
-- **Missing dependencies**: Always run `pnpm install` first
-
-#### Component and Styling Issues
-
-- **Custom HTML not working**: Replace with React Bootstrap components
-- **Translation not showing**: Ensure all text uses `t()` function and keys exist in all language files
-- **GitHub API errors**: Verify you're using configured `githubClient` from `models/Base.ts`
-
-#### Data and Content Issues
-
-- **Base64 content errors**: Use `atob(item.content)` to decode GitHub API responses
-- **Missing content**: Check ContentModel configuration and repository access
-- **Tree structure problems**: Use `treeFrom()` utility from web-utility
-
-### Development Environment Setup
-
-- Clear browser cache if components don't render properly
-- Restart development server after major configuration changes
-- Verify all translation files are updated when adding new keys
-
-## Project-Specific Patterns
-
-### Wiki System Architecture
-
-- Uses GitHub ContentModel to access policy documents from `fpsig/open-source-policy` repository
-- Renders markdown content with front-matter metadata
-- Supports hierarchical document structure with breadcrumb navigation
-
-### License Filter Integration
-
-- Interactive multi-step license selection process
-- Uses `license-filter` package for license recommendation logic
-- Supports multiple languages with comprehensive i18n coverage
-
-### Volunteer Management
-
-- Displays GitHub organization contributors
-- Integrates with OSS Insight widgets for contributor analytics
-- Uses GitHub API for real-time contributor data
-
-Always prioritize these project-specific standards over generic Next.js or React guidance when working in this specific codebase.
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..9bdafc8
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,186 @@
+# Open Source Bazaar 编程规范
+
+本文档适用于本仓库的代码、测试和文档变更。修改前先理解现有实现与调用关系,遵循仓库已有模式;只实现明确要求的内容,不擅自扩展功能或修复无关问题。
+
+## 项目与依赖
+
+- 本项目使用 Next.js、TypeScript、React、Idea React 和 MobX。优先复用现有依赖、组件、模型和工具,不重复实现已有能力。
+- Node.js 版本要求为 22 或更高;依赖管理和开发命令遵循仓库当前使用的 PNPM 与锁文件,不要擅自固定未经仓库约定的包管理器版本。
+- 共用脚本、Git hooks 和 CI 命令应保持跨环境兼容,不依赖开发者机器上的绝对路径或特定本机安装方式。
+
+## TypeScript、数据与集成
+
+- 保留类型安全:明确数据结构和字段类型;动态加载组件时提供正确的 props 类型。能由 TypeScript 推断时不添加冗余类型声明。
+- 复用重复表达式、网址和列表数据:适合时提取常量,并由数组迭代生成结构重复的内容。
+- 使用项目既有的模型和工具:GitHub 集成使用 `models/Base.ts` 中配置的客户端;模型按需导入 `'./Base'` 完成配置。使用 `ContentModel`、`treeFrom()` 等现有能力,而不是另造实现。
+- 保持错误可见。不要吞掉异常、静默返回成功形状的默认值,或以无效输入掩盖问题;静态生成期间让错误自然抛出,以便构建及时暴露问题。
+
+## 文案与国际化
+
+- 所有用户可见文案(包括标题、按钮、标签、统计项、提示和动态文本)都必须通过现有 i18n 机制获取,不要硬编码在组件中。
+- 新增翻译键时,更新 `translation/` 中所有受支持语言文件(`zh-TW.ts`、`zh-CN.ts`、`en-US.ts`);移除或替换文案时,清理不再使用的键。
+- 翻译键优先使用通用概念;只有确有范围区分时才使用具体限定词。
+
+## 组件风格
+
+1. 组件应保持单一职责并可复用,不与具体页面或路由耦合;页面布局和路由分支由应用层处理。
+2. Bootstrap UI 优先使用 Idea React 组件,避免用自定义 HTML 和 `className` 重造已有组件。
+3. 选择合适的语义元素(如 ``、``、``),有序步骤使用 ``、无序列表使用 `