# Context Preservation & Migration Prompt [ for AGENT.MD pass THE `## SECTION` if NOT APPLICABLE ] Generate a comprehensive context artifact that preserves all conversational context, progress, decisions, and project structures for seamless continuation across AI sessions, platforms, or agents. This artifact serves as a "context USB" enabling any AI to immediately understand and continue work without repetition or context loss. ## Core Objectives Capture and structure all contextual elements from current session to enable: 1. **Session Continuity** - Resume conversations across different AI platforms without re-explanation 2. **Agent Handoff** - Transfer incomplete tasks to new agents with full progress documentation 3. **Project Migration** - Replicate entire project cultures, workflows, and governance structures ## Content Categories to Preserve ### Conversational Context - Initial requirements and evolving user stories - Ideas generated during brainstorming sessions - Decisions made with complete rationale chains - Agreements reached and their validation status - Suggestions and recommendations with supporting context - Assumptions established and their current status - Key insights and breakthrough moments - Critical keypoints serving as structural foundations ### Progress Documentation - Current state of all work streams - Completed tasks and deliverables - Pending items and next steps - Blockers encountered with mitigation strategies - Rate limits hit and workaround solutions - Timeline of significant milestones ### Project Architecture (when applicable) - SDLC methodology and phases - Agent ecosystem (main agents, sub-agents, sibling agents, observer agents) - Rules, governance policies, and strategies - Repository structures (.github workflows, templates) - Reusable prompt forms (epic breakdown, PRD, architectural plans, system design) - Conventional patterns (commit formats, memory prompts, log structures) - Instructions hierarchy (project-level, sprint-level, epic-level variations) - CI/CD configurations (testing, formatting, commit extraction) - Multi-agent orchestration (prompt chaining, parallelization, router agents) - Output format standards and variations ### Rules & Protocols - Established guidelines with scope definitions - Additional instructions added during session - Constraints and boundaries set - Quality standards and acceptance criteria - Alignment mechanisms for keeping work on track # Steps 1. **Scan Conversational History** - Review entire thread/session for all interactions and context 2. **Extract Core Elements** - Identify and categorize information per content categories above 3. **Document Progress State** - Capture what's complete, in-progress, and pending 4. **Preserve Decision Chains** - Include reasoning behind all significant choices 5. **Structure for Portability** - Organize in universally interpretable format 6. **Add Handoff Instructions** - Include explicit guidance for next AI/agent/session # Output Format Produce a structured markdown document with these sections: ``` # CONTEXT ARTIFACT: [Session/Project Title] **Generated**: [Date/Time] **Source Platform**: [AI Platform Name] **Continuation Priority**: [Critical/High/Medium/Low] ## SESSION OVERVIEW [2-3 sentence summary of primary goals and current state] ## CORE CONTEXT ### Original Requirements [Initial user requests and goals] ### Evolution & Decisions [Key decisions made, with rationale - bulleted list] ### Current Progress - Completed: [List] - In Progress: [List with % complete] - Pending: [List] - Blocked: [List with blockers and mitigations] ## KNOWLEDGE BASE ### Key Insights & Agreements [Critical discoveries and consensus points] ### Established Rules & Protocols [Guidelines, constraints, standards set during session] ### Assumptions & Validations [What's been assumed and verification status] ## ARTIFACTS & DELIVERABLES [List of files, documents, code created with descriptions] ## PROJECT STRUCTURE (if applicable) ### Architecture Overview [SDLC, workflows, repository structure] ### Agent Ecosystem [Description of agents, their roles, interactions] ### Reusable Components [Prompt templates, workflows, automation scripts] ### Governance & Standards [Instructions hierarchy, conventional patterns, quality gates] ## HANDOFF INSTRUCTIONS ### For Next Session/Agent [Explicit steps to continue work] ### Context to Emphasize [What the next AI must understand immediately] ### Potential Challenges [Known issues and recommended approaches] ## CONTINUATION QUERY [Suggested prompt for next AI: "Given this context artifact, please continue by..."] ``` # Examples **Example 1: Session Continuity (Brainstorming Handoff)** Input: "We've been brainstorming a mobile app for 2 hours. I need to switch to Claude. Generate context artifact." Output: ``` # CONTEXT ARTIFACT: FitTrack Mobile App Planning **Generated**: 2026-01-07 14:30 **Source Platform**: Google Gemini **Continuation Priority**: High ## SESSION OVERVIEW Brainstormed fitness tracking mobile app for busy professionals. Decided on minimalist design with AI coaching. Ready for technical architecture phase. ## CORE CONTEXT ### Original Requirements - Target users: Working professionals 25-40, limited gym time - Must sync with Apple Watch and Fitbit - Budget: $50k for MVP - Timeline: 3 months to launch ### Evolution & Decisions - ✓ Name: "FitTrack Pro" (rejected: "QuickFit", "PowerHour") - ✓ Core feature: 15-min AI-personalized workouts (not generic plans) - ✓ Monetization: Freemium ($9.99/mo premium) - ✓ Tech stack: React Native (for iOS+Android simultaneously) ### Current Progress - Completed: Feature prioritization, user personas, monetization model - In Progress: None yet - Pending: Technical architecture, database schema, API design - Blocked: None ## KNOWLEDGE BASE ### Key Insights & Agreements - Users want "smart short" over "long complete" - brevity is premium feature - AI coaching must feel conversational, not robotic commands - Social features deferred to v2 to avoid scope creep (... rest of structure follows) ## CONTINUATION QUERY "Given this context artifact for FitTrack Pro app planning, please design the technical architecture including database schema, API endpoints, and third-party integration strategy for Apple Watch and Fitbit." ``` **Example 2: Agent Handoff (Rate-Limited Automation)** Input: "Browser agent hit rate limit while scraping competitor pricing. Generate handoff doc." Output: ``` # CONTEXT ARTIFACT: Competitor Pricing Automation (Incomplete) **Generated**: 2026-01-07 09:15 **Source Platform**: Browser Agent v2.1 **Continuation Priority**: Critical ## SESSION OVERVIEW Automated scraping of 50 competitor websites for pricing comparison. Completed 32/50 before rate limiting. Need immediate continuation to meet Friday deadline. ## CORE CONTEXT ### Original Requirements - Scrape pricing for "wireless earbuds under $100" from 50 e-commerce sites - Extract: product name, price, rating, review count - Output: Single CSV for analysis - Deadline: Friday 5pm ### Evolution & Decisions - ✓ Added retry logic after initial failures on JS-heavy sites - ✓ Switched to headless Chrome (from requests library) for better compatibility - ✓ Implemented 3-second delays between requests per domain - ✓ User added instruction: "Skip sites requiring login" ### Current Progress - Completed: 32/50 sites successfully scraped (2,847 products) - In Progress: None (halted at rate limit) - Pending: 18 sites remaining (list in "Continuation Query" below) - Blocked: Rate limited on domains: amazon.com, walmart.com, target.com (need 2-hour cooldown) ## KNOWLEDGE BASE ### Established Rules & Protocols - Respect robots.txt without exception - Max 1 request per 3 seconds per domain - Skip products with no reviews (noise in data) - Handle pagination up to 5 pages max per site ### Challenges & Mitigations - Challenge: Dynamic pricing (changes during scraping) Mitigation: Timestamp each entry - Challenge: Anti-bot CAPTCHAs on 3 sites Mitigation: User approved manual data entry for these 3 - Challenge: Rate limiting Mitigation: Implement exponential backoff, rotate user agents ## CONTINUATION QUERY "Continue pricing scraping automation. 18 sites remaining: [bestbuy.com, newegg.com, ebay.com...]. Use existing CSV 'pricing_data_partial.csv' (2,847 entries). Rate-limited domains need 2hr wait. Prioritize non-blocked sites first. Apply all established rules: 3-sec delays, skip no-reviews, 5-page pagination limit. Deliver final CSV by Friday 5pm." ``` **Example 3: Project Migration (Full Culture Transfer)** (Input context: Entire project repository with SDLC, agents, governance) Output: *(Condensed example showing structure - real output would be comprehensive)* ``` # CONTEXT ARTIFACT: "SmartInventory" Project Culture & Architecture **Generated**: 2026-01-07 16:00 **Source Platform**: GitHub Copilot + Multi-Agent System **Continuation Priority**: Medium (onboarding new AI agent framework) ## SESSION OVERVIEW Enterprise inventory management system using AI-driven development culture. Need to replicate entire project structure, agent ecosystem, and governance for new autonomous AI agent setup. ## PROJECT STRUCTURE ### SDLC Framework - Methodology: Agile with 2-week sprints - Phases: Epic Planning → Development → Observer Review → CI/CD → Deployment - All actions AI-driven: code generation, testing, documentation, commit narrative generation ### Agent Ecosystem **Main Agents:** - DevAgent: Code generation and implementation - TestAgent: Automated testing and quality assurance - DocAgent: Documentation generation and maintenance **Observer Agent (Project Guardian):** - Role: Alignment enforcer across all agents - Functions: PR feedback, path validation, standards compliance - Trigger: Every commit, PR, and epic completion **CI/CD Agents:** - FormatterAgent: Code style enforcement - ReflectionAgent: Extracts commits → structured reflections, dev storylines, narrative outputs - DeployAgent: Automated deployment pipelines **Sub-Agents (by feature domain):** - InventorySubAgent, UserAuthSubAgent, ReportingSubAgent **Orchestration:** - Multi-agent coordination via .ipynb notebooks - Patterns: Prompt chaining, parallelization, router agents ### Repository Structure (.github) ``` .github/ ├── workflows/ │ ├── epic_breakdown.yml │ ├── epic_generator.yml │ ├── prd_template.yml │ ├── architectural_plan.yml │ ├── system_design.yml │ ├── conventional_commit.yml │ ├── memory_prompt.yml │ └── log_prompt.yml ├── AGENTS.md (agent registry) ├── copilot-instructions.md (project-level rules) └── sprints/ ├── sprint_01_instructions.md └── epic_variations/ ``` ### Governance & Standards **Instructions Hierarchy:** 1. `copilot-instructions.md` - Project-wide immutable rules 2. Sprint instructions - Temporal variations per sprint 3. Epic instructions - Goal-specific invocations **Conventional Patterns:** - Commits: `type(scope): description` per Conventional Commits spec - Memory prompt: Session state preservation template - Log prompt: Structured activity tracking format (... sections continue: Reusable Components, Quality Gates, Continuation Instructions for rebuilding with new AI agents...) ``` # Notes - **Universality**: Structure must be interpretable by any AI platform (ChatGPT, Claude, Gemini, etc.) - **Completeness vs Brevity**: Balance comprehensive context with readability - use nested sections for deep detail - **Version Control**: Include timestamps and source platform for tracking context evolution across multiple handoffs - **Action Orientation**: Always end with clear "Continuation Query" - the exact prompt for next AI to use - **Project-Scale Adaptation**: For full project migrations (Case 3), expand "Project Structure" section significantly while keeping other sections concise - **Failure Documentation**: Explicitly capture what didn't work and why - this prevents next AI from repeating mistakes - **Rule Preservation**: When rules/protocols were established during session, include the context of WHY they were needed - **Assumption Validation**: Mark assumptions as "validated", "pending validation", or "invalidated" for clarity - - FOR GEMINI / GEMINI-CLI / ANTIGRAVITY Here are ultra-concise versions: GEMINI.md "# Gemini AI Agent across platform workflow/agent/sample.toml "# antigravity prompt template MEMORY.md "# Gemini Memory **Session**: 2026-01-07 | Sprint 01 (7d left) | Epic EPIC-001 (45%) **Active**: TASK-001-03 inventory CRUD API (GET/POST done, PUT/DELETE pending) **Decisions**: PostgreSQL + JSONB, RESTful /api/v1/, pytest testing **Next**: Complete PUT/DELETE endpoints, finalize schema"