diff --git a/README.md b/README.md
index 6c6af6a..781903c 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,188 @@
-`<!-- placeholder for codex to edit -->`
+<purpose>
+  Provide a formal report that identifies the top 10 GitHub repositories most similar
+  to the Forky project (conversation branching, DAG-based chat management, and LLM
+  workflows), based solely on the user-supplied description and the GitHub search
+  results captured in the attachment data.
+</purpose>
+
+<context>
+  <role>
+    Documentation Analyst / Technical Revisor.
+    <tone>Formal, coherent, impersonal, and extensive.</tone>
+    <domain>Repository Similarity Analysis for LLM Tooling.</domain>
+  </role>
+
+  <input_handling>
+      Treat [[attachment_files]] as the textual data extracted from the GitHub API
+      search responses stored locally for this task.
+  </input_handling>
+
+  <constraints>
+    <constraint type="critical">TOTAL SANITIZATION: No identifiers or factual
+    statements from the template may remain; all content is replaced with Forky
+    and similarity-search data.</constraint>
+    <constraint type="critical">INFERENCE ALLOWED: Similarity ordering is inferred
+    using repository descriptions, topics, and stated features.</constraint>
+    <constraint type="critical">CONFLICT RESOLUTION: If data sources conflict, both
+    values are recorded with source tags.</constraint>
+    <constraint type="formatting">PRESERVE STRUCTURE: Maintain the hierarchy,
+    section order, and list styles of the template where possible.</constraint>
+  </constraints>
+</context>
+
+<instructions>
+  <instruction step="1">STRUCTURAL MAPPING: Identify fixed sections and variable
+  fields within this document template.</instruction>
+
+  <instruction step="2">DATA EXTRACTION:
+    a. Extract the target repository purpose and features from [[new_raw_data]].
+    b. Extract candidate repositories from [[attachment_files]].</instruction>
+
+  <instruction step="3">CONFLICT CHECK: Compare overlapping fields (e.g.,
+  descriptions or topics) and capture discrepancies if found.</instruction>
+
+  <instruction step="4">DRAFTING & SUBSTITUTION:
+    a. Rebuild the document using this structure.
+    b. Replace all sections with Forky-specific task details and similarity results.
+    c. Provide a ranked list of 10 similar repositories with brief rationales.</instruction>
+
+  <instruction step="5">LIST HANDLING:
+    a. Use ordered lists for ranked repositories.
+    b. Include only repositories present in the attachment data.
+    c. Do not retain unused template items.</instruction>
+
+  <instruction step="6">GAP FILLING: If the raw data omits a field (e.g.,
+  explicit similarity criteria), infer it based on standard repository analysis.</instruction>
+
+  <instruction step="7">DISCREPANCY REPORTING: If conflicts exist, add an
+  OBSERVATIONS section at the end and list both values with sources.</instruction>
+
+  <instruction step="8">ANTI-RESIDUE SCAN: Ensure no template-specific details
+  remain in the final output.</instruction>
+</instructions>
+
+<variables>
+  <variable name="[[task_request]]" required="true">
+    <description>Identify the 10 GitHub repositories most similar to Forky.</description>
+  </variable>
+  <variable name="[[target_repo_url]]" required="true">
+    <description>https://github.com/ishandhanani/forky</description>
+  </variable>
+  <variable name="[[similarity_criteria]]" required="true">
+    <description>
+      Overlap in conversation branching, DAG or tree structures, multi-path chat
+      exploration, LLM-driven chat management, and graph visualization.
+    </description>
+  </variable>
+  <variable name="[[data_sources]]" required="true">
+    <description>
+      User-provided Forky description (raw data) and GitHub Search API results
+      stored in similar_repos.json (attachment data).
+    </description>
+  </variable>
+</variables>
+
+<input_data>
+  <template_document><![CDATA[
+    [[Template content fully replaced with Forky similarity analysis.]]
+  ]]></template_document>
+
+  <new_raw_data><![CDATA[
+    Target repository: Forky (Git-style conversation management for LLMs).
+    Key concepts: conversation DAG, branching, checkout, semantic merge,
+    multi-provider LLM support, web/CLI interfaces, and graph visualization.
+  ]]></new_raw_data>
+
+  <attachment_files><![CDATA[
+    Extracted GitHub Search API candidates from similar_repos.json, including
+    repository names, URLs, descriptions, topics, and star counts.
+  ]]></attachment_files>
+</input_data>
+
+<output_format_specification>
+  <format>Plain text or Markdown, strictly mirroring the layout of the template.</format>
+  <language>en_US</language>
+</output_format_specification>
+
+<examples>
+  <example>
+    <scenario>Top 10 Similar GitHub Repositories to Forky</scenario>
+    <output_fragment><![CDATA[
+      1) akivacp/chatgpt-json-tree-viewer
+         URL: https://github.com/akivacp/chatgpt-json-tree-viewer
+         Rationale: Visualizes branching conversation trees, aligning with Forky’s
+         graph-based chat history exploration.
+
+      2) ivanbaluta/aistudio-chat-visualizer
+         URL: https://github.com/ivanbaluta/aistudio-chat-visualizer
+         Rationale: Interactive branching tree graph for chats, similar DAG
+         navigation focus.
+
+      3) iterabloom/BranchyMcChatFace
+         URL: https://github.com/iterabloom/BranchyMcChatFace
+         Rationale: Explicit conversation branching with dialogue trees and
+         visualization.
+
+      4) tldraw/branching-chat-template
+         URL: https://github.com/tldraw/branching-chat-template
+         Rationale: Visual branching conversation interface with AI integration.
+
+      5) PaoloJN/ai-chat-tree
+         URL: https://github.com/PaoloJN/ai-chat-tree
+         Rationale: Hierarchical AI chat conversations with branching contexts.
+
+      6) jamwalsudip/chatgpt-branching
+         URL: https://github.com/jamwalsudip/chatgpt-branching
+         Rationale: Branching conversation tree tracker for ChatGPT.
+
+      7) Utsav-Ladani/Chat-Trees
+         URL: https://github.com/Utsav-Ladani/Chat-Trees
+         Rationale: Branching conversation tree app for AI chats.
+
+      8) harriety/tree-chat
+         URL: https://github.com/harriety/tree-chat
+         Rationale: Tree-structured chat interface for multi-path reasoning.
+
+      9) sbeeredd04/Aether
+         URL: https://github.com/sbeeredd04/Aether
+         Rationale: Chat multiverse with visual tree exploration and multi-model
+         support.
+
+      10) Tiledesk/design-studio
+          URL: https://github.com/Tiledesk/design-studio
+          Rationale: Graph-based conversation designer with LLM/GPT focus.
+    ]]></output_fragment>
+  </example>
+</examples>
+
+<self_check>
+  <checklist>
+    <item>All content is derived from Forky’s description and GitHub search data.</item>
+    <item>Top 10 list contains only repositories present in attachment data.</item>
+    <item>Template-specific facts are fully removed.</item>
+    <item>No conflicts detected between raw and attachment data.</item>
+  </checklist>
+</self_check>
+
+<evaluation_notes>
+  <test_cases>
+    <case>Branching conversation visualization tools</case>
+    <case>Conversation tree or DAG management interfaces</case>
+    <case>LLM chat systems with graph-based navigation</case>
+    <case>Conversation designers using graph structures</case>
+  </test_cases>
+  <success_definition>Top 10 similar repositories are listed with URLs and
+  rationales aligned to Forky’s conversation DAG and branching model.</success_definition>
+</evaluation_notes>
+
+<documentation>
+  <usage>
+    <step>Use the provided Forky summary to define similarity criteria.</step>
+    <step>Review GitHub API candidates and rank the top 10 by feature overlap.</step>
+    <step>Publish a formal list with repository names, links, and rationales.</step>
+  </usage>
+  <known_limitations>
+    <limitation>Similarity is inferred from public descriptions and topics.</limitation>
+    <limitation>Search results reflect GitHub API ranking at query time.</limitation>
+  </known_limitations>
+</documentation>
diff --git a/similar_repos.json b/similar_repos.json
new file mode 100644
index 0000000..625006c
--- /dev/null
+++ b/similar_repos.json
@@ -0,0 +1,184 @@
+{
+  "query_results": [
+    {
+      "full_name": "akivacp/chatgpt-json-tree-viewer",
+      "html_url": "https://github.com/akivacp/chatgpt-json-tree-viewer",
+      "description": "A standalone, offline HTML viewer for exploring and visualizing ChatGPT, DeepSeek, Claude, Grok, and Mistral conversation exports in a branching tree format.",
+      "stargazers_count": 31,
+      "topics": [
+        "chatgpt",
+        "claude",
+        "data-visualization",
+        "deepseek",
+        "graph",
+        "grok",
+        "html",
+        "javascript",
+        "json",
+        "json-viewer",
+        "mistral-ai",
+        "offline",
+        "openai-chatgpt",
+        "visualization"
+      ]
+    },
+    {
+      "full_name": "ivanbaluta/aistudio-chat-visualizer",
+      "html_url": "https://github.com/ivanbaluta/aistudio-chat-visualizer",
+      "description": "An interactive tool to visualize your Google AI Studio chat conversations as a branching tree graph.",
+      "stargazers_count": 5,
+      "topics": [
+        "chat-visualizer",
+        "data-visualization",
+        "gemini-ai",
+        "google-ai-studio",
+        "google-drive-api",
+        "graph-visualization",
+        "javascript",
+        "python",
+        "tree-visualization",
+        "vis-js"
+      ]
+    },
+    {
+      "full_name": "iterabloom/BranchyMcChatFace",
+      "html_url": "https://github.com/iterabloom/BranchyMcChatFace",
+      "description": "Chat interface with conversation branching. Explore dialogue trees, visualize chat paths, and interact with multiple LLMs.",
+      "stargazers_count": 4,
+      "topics": []
+    },
+    {
+      "full_name": "PavanVkAlapati/zep_memory_bot",
+      "html_url": "https://github.com/PavanVkAlapati/zep_memory_bot",
+      "description": "Streamlit chatbot with Zep-backed long-term memory and interactive knowledge graph visualization of conversations.",
+      "stargazers_count": 2,
+      "topics": [
+        "ai-agent",
+        "conversational-ai",
+        "graph-visualisation",
+        "knowledge-graph",
+        "llm",
+        "long-term-memory",
+        "streamlit",
+        "vectordb",
+        "zep"
+      ]
+    },
+    {
+      "full_name": "umerrafiq04/AI-Conversational-Chatbot-with-LangGraph-Mistral",
+      "html_url": "https://github.com/umerrafiq04/AI-Conversational-Chatbot-with-LangGraph-Mistral",
+      "description": "AI-powered conversational chatbot built with LangGraph and Mistral, enabling structured, multi-step reasoning and context-aware responses. Designed for scalable, intelligent conversations using modern LLM orchestration and retrieval-based workflows.",
+      "stargazers_count": 0,
+      "topics": []
+    },
+    {
+      "full_name": "Tiledesk/design-studio",
+      "html_url": "https://github.com/Tiledesk/design-studio",
+      "description": "Tiledesk's open-source visual, no-code designer where LLM/GPT AI meets a flexible 'graph' approach. Create conversations and automations effortlessly \u2013 a Voiceflow and Botpress alternative.",
+      "stargazers_count": 439,
+      "topics": [
+        "automation-tool",
+        "bot-builder",
+        "botpress-alternative",
+        "chatbot-development",
+        "conversation-designer",
+        "conversational-ui",
+        "design-studio",
+        "github-project",
+        "github-repository",
+        "gpt-ai",
+        "graph-visualization",
+        "llm",
+        "multichannel",
+        "no-code",
+        "open-source",
+        "visual-designer",
+        "voiceflow-alternative"
+      ]
+    },
+    {
+      "full_name": "shreyasharma04/HealthChatbot",
+      "html_url": "https://github.com/shreyasharma04/HealthChatbot",
+      "description": "\ud83e\udd16 HealthCare ChatBot Major -1 (4th year - 7th semester)  Health Care Chat-Bot is a Healthcare Domain Chatbot to simulate the predictions of a General Physician.  ChatBot can be described as software that can chat with people using artificial intelligence. These software are used to perform tasks such as quickly responding to users, informing them, helping to purchase products and providing better service to customers. We have made a healthcare based chatbot.  The three main areas where chatbots can be used are diagnostics, patient engagement outside medical facilities, and mental health. In our major we are working on diagnostic.  \ud83d\udcc3 Brief A chatbot is an artificially intelligent creature which can converse with humans. This could be text-based, or a spoken conversation. In our project we will be using Python as it is currently the most popular language for creating an AI chatbot. In the middle of AI chatbot, architecture is the Natural Language Processing (NLP) layer.  This project aims to build an user-friendly healthcare chatbot which facilitates the job of a healthcare provider and helps improve their performance by interacting with users in a human-like way.  Through chatbots one can communicate with text or voice interface and get reply through artificial intelligence  Typically, a chat bot will communicate with a real person. Chat bots are used in applications such as E-commerce customer service, Call centres, Internet gaming,etc.  Chatbots are programs built to automatically engage with received messages. Chatbots can be programmed to respond the same way each time, to respond differently to messages containing certain keywords and even to use machine learning to adapt their responses to fit the situation.  A developing number of hospitals, nursing homes, and even private centres, presently utilize online Chatbots for human services on their sites. These bots connect with potential patients visiting the site, helping them discover specialists, booking their appointments, and getting them access to the correct treatment.  In any case, the utilization of artificial intelligence in an industry where individuals\u2019 lives could be in question, still starts misgivings in individuals. It brings up issues about whether the task mentioned above ought to be assigned to human staff. This healthcare chatbot system will help hospitals to provide healthcare support online 24 x 7, it answers deep as well as general questions. It also helps to generate leads and automatically delivers the information of leads to sales. By asking the questions in series it helps patients by guiding what exactly he/she is looking for.  \ud83d\udcdc Problem Statement During the pandemic, it is more important than ever to get your regular check-ups and to continue to take prescription medications. The healthier you are, the more likely you are to recover quickly from an illness.  In this time patients or health care workers within their practice, providers are deferring elective and preventive visits, such as annual physicals. For some, it is not possible to consult online. In this case, to avoid false information, our project can be of help.  \ud83d\udcc7 Features Register Screen. Sign-in Screen. Generates database for user login system. Offers you a GUI Based Chatbot for patients for diagnosing. [A pragmatic Approach for Diagnosis] Reccomends an appropriate doctor to you for the following symptom. \ud83d\udcdc Modules Used Our program uses a number of python modules to work properly:  tkinter os webbrowser numpy pandas matplotlib \ud83d\udcc3 Algorithm We have used Decision tree for our health care based chat bot.  Decision Tree is a Supervised learning technique that can be used for both classification and Regression problems, but mostly it is preferred for solving Classification problems. It is a tree-structured classifier, where internal nodes represent the features of a dataset, branches represent the decision rules and each leaf node represents the outcome.It usually mimic human thinking ability while making a decision, so it is easy to understand.  :suspect: Project Members Anushka Bansal - 500067844 - R164218014 Shreya Sharma - 500068573 - R164218070 Silvi - 500069092 - R164218072 Ishika Agrawal - 500071154 - R164218097",
+      "stargazers_count": 121,
+      "topics": []
+    },
+    {
+      "full_name": "leslieo2/LieGraph",
+      "html_url": "https://github.com/leslieo2/LieGraph",
+      "description": "  LieGraph - AI Agent-Driven \"Who Is Spy\" Game. Multi-agent social deduction game built with LangGraph where autonomous AI agents use LLM reasoning to find the spy through   conversation analysis and strategic voting.",
+      "stargazers_count": 58,
+      "topics": [
+        "agent",
+        "ai",
+        "game",
+        "langgraph",
+        "multi-agent",
+        "python"
+      ]
+    },
+    {
+      "full_name": "PaoloJN/ai-chat-tree",
+      "html_url": "https://github.com/PaoloJN/ai-chat-tree",
+      "description": "Obsidian plugin for hierarchical AI-driven conversations. AI Chat Tree enables interactive discussions with GPT/SearchAI within canvas notes, preserving context across branching conversations.",
+      "stargazers_count": 11,
+      "topics": [
+        "ai",
+        "chatgpt",
+        "obsidian",
+        "obsidian-plugin"
+      ]
+    },
+    {
+      "full_name": "tldraw/branching-chat-template",
+      "html_url": "https://github.com/tldraw/branching-chat-template",
+      "description": "Create interactive chat trees using visual branching conversation interface with AI integration.",
+      "stargazers_count": 7,
+      "topics": []
+    },
+    {
+      "full_name": "sbeeredd04/Aether",
+      "html_url": "https://github.com/sbeeredd04/Aether",
+      "description": "Aether AI - Chat Multiverse transforms linear AI conversations into explorable, visual trees. It offers infinite branching, support for multiple AI models , web-grounded responses, rich media integration",
+      "stargazers_count": 4,
+      "topics": [
+        "ai-chat",
+        "ai-chat-multiverse",
+        "chat-application",
+        "conversation-trees",
+        "gemini-api",
+        "multithreading",
+        "nextjs",
+        "react-flow"
+      ]
+    },
+    {
+      "full_name": "jamwalsudip/chatgpt-branching",
+      "html_url": "https://github.com/jamwalsudip/chatgpt-branching",
+      "description": "Visual conversation tree tracker for ChatGPT with branching support",
+      "stargazers_count": 3,
+      "topics": []
+    },
+    {
+      "full_name": "Utsav-Ladani/Chat-Trees",
+      "html_url": "https://github.com/Utsav-Ladani/Chat-Trees",
+      "description": "AI-powered chat app that lets you branch conversations as a tree. Explore ideas, track discussions, and generate insights with ease.",
+      "stargazers_count": 2,
+      "topics": []
+    },
+    {
+      "full_name": "harriety/tree-chat",
+      "html_url": "https://github.com/harriety/tree-chat",
+      "description": "Tree-Chat is an chat interface that organizes conversations as a tree instead of a flat thread, enabling structured thinking, branching exploration, and multi-path reasoning.",
+      "stargazers_count": 1,
+      "topics": []
+    },
+    {
+      "full_name": "Md-AdeebKhan/LangGraph-Streamlit-Chatbot",
+      "html_url": "https://github.com/Md-AdeebKhan/LangGraph-Streamlit-Chatbot",
+      "description": "LangGraph-powered Streamlit chatbot with persistent memory, multi-threaded conversations, and Groq LLM integration.",
+      "stargazers_count": 0,
+      "topics": []
+    }
+  ]
+}
\ No newline at end of file