{"id":51186748,"url":"https://github.com/ayush00git/socratic","last_synced_at":"2026-06-27T11:02:38.344Z","repository":{"id":366361877,"uuid":"1275990591","full_name":"ayush00git/socratic","owner":"ayush00git","description":"your AI thinking partner, helps evaluate your queries better then any generic AI chatbot response","archived":false,"fork":false,"pushed_at":"2026-06-21T13:29:31.000Z","size":11086,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-21T14:38:51.944Z","etag":null,"topics":["ai","anna"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ayush00git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-21T12:00:48.000Z","updated_at":"2026-06-21T13:29:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ayush00git/socratic","commit_stats":null,"previous_names":["ayush00git/socratic"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ayush00git/socratic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayush00git%2Fsocratic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayush00git%2Fsocratic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayush00git%2Fsocratic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayush00git%2Fsocratic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ayush00git","download_url":"https://codeload.github.com/ayush00git/socratic/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayush00git%2Fsocratic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34850575,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","anna"],"created_at":"2026-06-27T11:02:37.506Z","updated_at":"2026-06-27T11:02:38.339Z","avatar_url":"https://github.com/ayush00git.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Socratic — AI Thinking Partner\n\n\u003e Every AI tool answers questions. This one helps you ask better ones.\n\nSocratic is an AI-native app built on [Anna](https://anna.partners) that replaces the reflex of \"ask AI for an answer\" with something more valuable: a structured thinking workflow that helps you reason through decisions, plans, and problems properly.\n\n---\n\n## The Problem\n\nWhen you're stuck on a decision or a complex problem, getting an instant answer from an AI isn't always what you need. What you actually need is to think it through — to surface your hidden assumptions, challenge your framing, and understand what you truly know versus what you've taken for granted.\n\nSocratic is built for that exact moment.\n\n---\n\n## What It Does\n\n1. **Describe your problem** — paste in a decision, a plan, or a situation you're stuck on.\n2. **AI asks, not answers** — instead of giving you a solution, it asks you a sequence of probing questions using the Socratic method.\n3. **Answer in a structured UI** — your answers accumulate in a clean card stack, keeping the full thread visible.\n4. **Assumptions get surfaced** — at key points, the AI identifies hidden assumptions embedded in your own answers.\n5. **You review each assumption** — mark every surfaced assumption as **Valid**, **False**, or **Unknown**. The AI cannot know which assumptions hold for your situation — that human judgment is the entire point.\n6. **Clarity map generated** — once you've worked through the assumptions, the AI produces a structured summary: what you know, what you've assumed, and what remains genuinely uncertain.\n\n---\n\n## Why It's Different\n\nMost AI tools optimize for giving you an answer fast. Socratic optimizes for giving you clarity. The human review step — validating your own assumptions — is not a UX feature. It is the core of the workflow. No AI can substitute for that judgment, and Socratic doesn't try to.\n\nThis is not a chatbot. It is a structured reasoning workflow built as an Anna App, where AI participates through tool calls, state, and human review gates — not just a text box.\n\n---\n\n## Built On Anna\n\nSocratic is an [Anna App](https://anna.partners/developers) — an AI-native app prototype built on the Anna runtime and developer platform.\n\nAnna handles the platform layer: app runtime, tool calling, permissions, and human review flows. Socratic uses these primitives to wire together a multi-step AI workflow that no static page or plain chatbot could replicate.\n\n- **Tool calls** drive each questioning and assumption-surfacing step\n- **Structured UI** keeps the question/answer thread and assumption cards visible at all times\n- **Human review** gates the assumption validation — AI surfaces, human decides\n- **State** holds the evolving problem thread and clarity map across the session\n\n---\n\n## Tech Stack\n\n| Layer | Technology |\n|---|---|\n| App runtime | Anna (`@anna-ai/cli ^0.1.27`) |\n| Frontend | HTML, CSS, JavaScript |\n| AI workflow | Anna tools + skills |\n| Dev server | `anna-app dev` |\n\n---\n\n## How It Works\n\n### Step 1 — Describe your problem\n\nType in the decision or situation you're stuck on, or pick one of the example chips. Choose your session depth: **Quick (3 rounds)**, **Deep (5 rounds)**, or **Thorough (7 rounds)**.\n\n![Step 1 — Problem input screen](public/image1.png)\n\n---\n\n### Step 2 — AI generates your first question\n\nHit **Start thinking** and the AI goes to work. It reads your problem and crafts the sharpest probing question it can — not a generic one, something specific to what you wrote.\n\n![Step 2 — Thinking loading state](public/image2.png)\n\n---\n\n### Step 3 — Answer the question\n\nThe question appears with a round counter. Write your answer freely — the more honest and detailed, the better the assumptions the AI will surface.\n\n![Step 3 — Socratic question with answer input](public/image3.png)\n\n---\n\n### Step 4 — Review the hidden assumption\n\nAfter you submit, the AI extracts the single most important hidden assumption buried in your answer. You then decide: is it **Valid**, **False**, or **Unsure**? This judgment is yours — the AI cannot make it for you.\n\n![Step 4 — Hidden assumption card with validation buttons](public/image4.png)\n\n---\n\n### Step 5 — Complete all rounds\n\nSteps 3–4 repeat for each round. Once all rounds are done, you're shown a completion screen and invited to generate your Clarity Map.\n\n![Step 5 — Session complete screen](public/image5.png)\n\n---\n\n### Step 6 — Get your Clarity Map\n\nThe AI produces a structured summary split into two sections: **What you know** (explicit facts from your answers) and **What you've assumed** (each assumption colour-coded by your validation). Copy it to your notes or clipboard.\n\n![Step 6 — Clarity Map output](public/image6.png)\n\n---\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js installed on your machine\n- An Anna account — register at [anna.partners](https://anna.partners)\n\n### Installation\n\nInstall dependencies for both the root (Anna CLI) and the UI bundle (React + Vite):\n\n```bash\nnpm i              # installs Anna CLI at root\ncd bundle \u0026\u0026 npm i # installs React, Vite, and UI deps\ncd ..\n```\n\n### Login to Anna (first time only)\n\n```bash\nnpm run login\n```\n\nThis authenticates your local CLI against the Anna platform at `https://anna.partners`. You must be logged in before running the dev server.\n\n### Run locally\n\n```bash\nnpm run dev\n```\n\nThis starts the Anna dev server. Open the URL shown in your terminal to interact with Socratic locally.\n\n### Verify your setup\n\n```bash\nnpm run whoami   # confirms you're logged in\nnpm run doctor   # checks your environment is healthy\nnpm run validate # validates your Anna App config strictly\n```\n\n---\n\n## Project Structure\n\n```\nsocratic/\n├── package.json          # Project config and Anna CLI scripts\n├── manifest.json         # Anna App manifest (permissions, UI, executas)\n├── README.md             # You are here\n├── bundle/               # Frontend UI (static SPA)\n│   ├── index.html        # Main UI entry point\n│   ├── app.js            # App logic\n│   └── style.css         # Styles\n├── executas/             # Anna tool (executa) definitions\n│   └── socratic-engine/  # Core questioning \u0026 assumption-surfacing tool\n├── skills/               # Anna skill definitions\n│   └── SKILL.md          # Socratic coach skill\n└── fixtures/             # Dev fixtures for local testing\n    └── happy-path.jsonl  # Example session fixture\n```\n\n---\n\n## The Core Loop\n\n```\nUser describes problem\n        ↓\nAI asks first Socratic question\n        ↓\nUser answers → answer added to card stack\n        ↓\nAI asks follow-up question (repeat 3–5 rounds)\n        ↓\nAI surfaces hidden assumptions from answers\n        ↓\nUser reviews each assumption: Valid / False / Unknown\n        ↓\nAI generates Clarity Map\n(What you know · What you've assumed · What's uncertain)\n```\n\n---\n\n## Judging Notes (Anna Hackathon)\n\nThis project was built for the **Anna AI-Native App Hackathon** (deadline: Jun 22, 2025).\n\n| Criterion | How Socratic addresses it |\n|---|---|\n| **Usefulness** | Solves a real thinking bottleneck — decisions and plans where you need clarity, not just an answer |\n| **Working demo** | One focused loop: problem → questions → assumptions → clarity map |\n| **Meaningful use of AI** | AI drives questioning and assumption surfacing via tool calls; does not just generate text |\n| **Fit with Anna** | Human review is the product, not a UX layer — a perfect match for Anna's review primitives |\n| **Creativity** | No other AI tool takes the Socratic method seriously as a structured workflow app |\n\n---\n\n## Author\n\nBuilt by [Ayush](https://github.com/ayush00git) for the Anna AI-Native App Hackathon.\n\n---\n\n*Socratic — because thinking clearly is the skill that compounds.*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayush00git%2Fsocratic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fayush00git%2Fsocratic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayush00git%2Fsocratic/lists"}