For new or modified code, keep files directly under this directory generic and independent of any particular layer implementation. Put layer-specific behavior in layers/ or with the owning layer's code.…
Two applications, each its own pnpm workspace, plus product docs. Each area keeps its own guide; this file holds only what is true everywhere. apps/x consumes @rowboat/spaces-protocol and @rowboat/harbor from apps/harbor as link: dependencies — never file:, which pnpm copies at install time and which then goes stale during co-development. Build harbor before installing or testing x: zod is pinned to one version (4.2.1) in both workspaces. A mismatch breaks type identity across the link. CI (.github/workflows/x-tests.yml) builds harbor first…
Workspace memory for agents collaborating on this repository. Keep entries durable and broadly applicable; one-off task state belongs in chat or in a run thread, not here.
For Cursor, Cursor Cloud Agents, Google Antigravity, Gemini CLI, Grok Build, OpenAI Codex CLI, Cline, Aider, and any other agent harness that reads project-root agent instructions. Claude Code users: see CLAUDE.md instead. Every skill in skills/*/SKILL.md is authored to a portable subset of the Claude Code skill spec. Validate compatibility with your harness via: The check confirms each SKILL.md has the minimum frontmatter every harness expects (name, description, optional model, optional tools) and warns on Claude-Code-specific features (maxTurns, multi-line tool…
Purpose: Project-specific knowledge for AI coding agents (Antigravity, Cursor, Copilot, etc.) and humans working on this sample. Per-demo variation is passed at run time, never baked into the Python: Edit directly. No escaping rules apply. Validate with: Feature-dependent code is gated at run time, not generation time: Keep that pattern — do not reintroduce generation-time code selection. generateSetupScript still emits bash (BigQuery/Firestore provisioning, Dockerfile assembly, deployment). Inside those JS template literals: - Emit a literal bash ${VAR} as \${VAR}; a…
[!IMPORTANT] Before making any code changes, architectural decisions, or refactoring in this codebase, any skill, agent, or subagent MUST first read the service Technical Design Document (TDD) located at docs/TDD.md (in the docs/ subdirectory). This document contains the definitive architectural requirements, data flows, and design rationale for the service. No linter config is present; use go vet ./... for static checks. Strict Ports and Adapters (Hexagonal Architecture). The layers must not be mixed: Every adapter declares a compile-time interface satisfaction…
Repository-wide instructions live in .claude/CLAUDE.md. Please refer to that file for shared build commands, architecture, and conventions. Before opening a pull request, read the "Contribution Bar" section of that file.…
lark-cli is the official Lark/Feishu CLI for humans and AI agents. Optimize for predictable machine-readable behavior without making the human CLI worse. Keep each PR focused on one goal: CLI UX, reliability, simpler explicit code, or a useful gate. Done means the correct implementation surface, preserved contracts unless a break was requested, and reported checks. Public behavior, tests, lint, and CI define current contracts. Existing code is evidence, but a legacy exception is not precedent; Proposal documents are direction only.…
MCP for Beginners is an open-source educational curriculum for learning the Model Context Protocol (MCP) - a standardized framework for interactions between AI models and client applications. This repository provides comprehensive learning materials with hands-on code examples across multiple programming languages. This is a documentation-focused repository. Most setup occurs within individual sample projects and labs. Sample projects are located in: - 03-GettingStarted/samples/ - Language-specific examples - 03-GettingStarted/01-first-server/solution/ - First server implementations - 03-GettingStarted/02-client/solution/ - Client implementations - 11-MCPServerHandsOnLabs/ - Comprehensive…
MCP للمبتدئين هو منهج تعليمي مفتوح المصدر لتعلم بروتوكول سياق النموذج (MCP) - إطار عمل معياري للتفاعلات بين نماذج الذكاء الاصطناعي وتطبيقات العملاء. يوفر هذا المستودع مواد تعليمية شاملة مع أمثلة تعليمية عملية عبر لغات برمجة متعددة. هذا المستودع موجه للوثائق. يتم معظم الإعداد داخل المشاريع النموذجية والمعامل الفردية. تقع المشاريع النموذجية في: - 03-GettingStarted/samples/ - أمثلة خاصة بكل لغة - 03-GettingStarted/01-first-server/solution/ - تنفيذات الخادم الأولى - 03-GettingStarted/02-client/solution/ - تنفيذات العميل - 11-MCPServerHandsOnLabs/ - معامل تكامل قواعد بيانات شاملة يحتوي…
MCP за начинаещи е отворен образователен курс за изучаване на Model Context Protocol (MCP) - стандартизиран рамков протокол за взаимодействия между AI модели и клиентски приложения. Това хранилище предоставя пълни учебни материали с практическо кодиране на няколко програмни езика. Това е подредено хранилище, фокусирано върху документацията. Повечето настройки се извършват в отделни примерни проекти и лаборатории. Примерните проекти се намират в: - 03-GettingStarted/samples/ - Езиково специфични примери - 03-GettingStarted/01-first-server/solution/ - Първи имплементации на сървър - 03-GettingStarted/02-client/solution/ - Клиентски имплементации -…
শুরুকারীদের জন্য MCP হল মডেল কন্টেক্সট প্রোটোকল (MCP) শেখার জন্য একটি ওপেন-সোর্স শিক্ষামূলক পাঠক্রম - যা AI মডেল এবং ক্লায়েন্ট অ্যাপ্লিকেশনের মধ্যে যোগাযোগের জন্য একটি মানসম্মত কাঠামো। এই রিপোজিটরিটি বিভিন্ন প্রোগ্রামিং ভাষায় হাতে-কলমে কোড উদাহরণের সাথে ব্যাপক শিক্ষামূলক উপকরণ সরবরাহ করে। এটি একটি ডকুমেন্টেশন-কেন্দ্রিক রিপোজিটরি। বেশিরভাগ সেটআপ আলাদা আলাদা নমুনা প্রকল্প এবং ল্যাবসের মধ্যে হয়। নমুনা প্রকল্পগুলি অবস্থিত: - 03-GettingStarted/samples/ - ভাষা-বিশেষ উদাহরণ - 03-GettingStarted/01-first-server/solution/ - প্রথম সার্ভার বাস্তবায়ন - 03-GettingStarted/02-client/solution/ - ক্লায়েন্ট বাস্তবায়ন - 11-MCPServerHandsOnLabs/ - পূর্ণাঙ্গ ডেটাবেস একীকরণ…
MCP pro začátečníky je open-source vzdělávací kurikulum pro získání znalostí o Model Context Protocol (MCP) – standardizovaném rámci pro interakce mezi AI modely a klientskými aplikacemi. Tento repozitář poskytuje komplexní výukové materiály s praktickými příklady kódu v několika programovacích jazycích. Toto je repozitář zaměřený na dokumentaci. Většina nastavení probíhá v jednotlivých ukázkových projektech a labech. Ukázkové projekty jsou umístěny v: - 03-GettingStarted/samples/ - Příklady specifické pro jazyk - 03-GettingStarted/01-first-server/solution/ - První implementace serveru - 03-GettingStarted/02-client/solution/ - Implementace klienta - 11-MCPServerHandsOnLabs/…
MCP for Beginners er en open-source uddannelsesplan til læring af Model Context Protocol (MCP) - en standardiseret ramme for interaktioner mellem AI-modeller og klientapplikationer. Dette repository indeholder omfattende læringsmaterialer med praktiske kodeeksempler på tværs af flere programmeringssprog. Dette er et dokumentationsfokuseret repository. Det meste opsætning sker indenfor individuelle eksempelprojekter og labs. Eksempelprojekter findes i: - 03-GettingStarted/samples/ - Sprog-specifikke eksempler - 03-GettingStarted/01-first-server/solution/ - Første server-implementeringer - 03-GettingStarted/02-client/solution/ - Klient-implementeringer - 11-MCPServerHandsOnLabs/ - Omfattende databaseintegrationslabs Hvert eksempelprojekt indeholder sine egne opsætningsinstruktioner: -…
MCP für Anfänger ist ein Open-Source-Bildungsprogramm zum Erlernen des Model Context Protocol (MCP) – ein standardisiertes Framework für Interaktionen zwischen KI-Modellen und Client-Anwendungen. Dieses Repository bietet umfassende Lernmaterialien mit praktischen Codebeispielen in mehreren Programmiersprachen. Dies ist ein dokumentationsorientiertes Repository. Das meiste Setup erfolgt innerhalb der einzelnen Beispielprojekte und Labs. Beispielprojekte befinden sich in: - 03-GettingStarted/samples/ - Sprachspezifische Beispiele - 03-GettingStarted/01-first-server/solution/ - Erste Server-Implementierungen - 03-GettingStarted/02-client/solution/ - Client-Implementierungen - 11-MCPServerHandsOnLabs/ - Umfassende Datenbankintegrations-Labs Jedes Beispielprojekt enthält eigene Setup-Anweisungen: - [x] Klarheit…
MCP για Αρχάριους είναι ένα ανοιχτού κώδικα εκπαιδευτικό πρόγραμμα για την εκμάθηση του Πρωτοκόλλου Πλαισίου Μοντέλου (MCP) - ένα τυποποιημένο πλαίσιο για αλληλεπιδράσεις μεταξύ μοντέλων AI και πελατειακών εφαρμογών. Αυτό το αποθετήριο παρέχει ολοκληρωμένα εκπαιδευτικά υλικά με πρακτικά παραδείγματα κώδικα σε πολλές γλώσσες προγραμματισμού. Αυτό είναι ένα αποθετήριο επικεντρωμένο στη τεκμηρίωση. Οι περισσότερες ρυθμίσεις γίνονται εντός μεμονωμένων δειγμάτων έργων και εργαστηρίων. Τα δείγματα έργων βρίσκονται σε: - 03-GettingStarted/samples/ - Παραδείγματα ανά γλώσσα - 03-GettingStarted/01-first-server/solution/ - Πρώτες υλοποιήσεις διακομιστή - 03-GettingStarted/02-client/solution/…
MCP for Beginners is an open-source educational curriculum for learning the Model Context Protocol (MCP) - a standardized framework for interactions between AI models and client applications. This repository provides comprehensive learning materials with hands-on code examples across multiple programming languages. This is a documentation-focused repository. Most setup occurs within individual sample projects and labs. Sample projects are located in: - 03-GettingStarted/samples/ - Language-specific examples - 03-GettingStarted/01-first-server/solution/ - First server implementations - 03-GettingStarted/02-client/solution/ - Client implementations - 11-MCPServerHandsOnLabs/ - Comprehensive…
MCP para Principiantes es un currículo educativo de código abierto para aprender el Model Context Protocol (MCP) - un marco estandarizado para las interacciones entre modelos de IA y aplicaciones cliente. Este repositorio proporciona materiales de aprendizaje completos con ejemplos prácticos de código en múltiples lenguajes de programación. Este es un repositorio enfocado en la documentación. La configuración principal ocurre dentro de proyectos de ejemplo y laboratorios individuales. Los proyectos de ejemplo se encuentran en: - 03-GettingStarted/samples/ - Ejemplos específicos…
Alustajate MCP on avatud lähtekoodiga hariduslik õppekava Model Context Protocol'i (MCP) õppimiseks – standardiseeritud raamistik tehisintellekti mudelite ja kliendirakenduste vaheliseks suhtluseks. See hoidla pakub põhjalikke õppematerjale ja praktilisi koodi näiteid mitmes programmeerimiskeeles. See on dokumentatsioonile keskenduv hoidla. Enamik seadistamist toimub individuaalsetes näidisprojektides ja töötubades. Näidisprojektid asuvad: - 03-GettingStarted/samples/ - keeltespetsiifilised näited - 03-GettingStarted/01-first-server/solution/ - Esimeste serveri rakenduste lahendused - 03-GettingStarted/02-client/solution/ - Kliendi rakendused - 11-MCPServerHandsOnLabs/ - Kõik kaetavad andmebaasi integreerimise töökodad Igas näidisprojektis on oma seadistusjuhised: - [x] Uue kaasautorina…
MCP برای مبتدیان یک برنامه آموزشی منبع باز برای یادگیری پروتکل زمینه مدل (MCP) است - یک چارچوب استاندارد برای تعاملات بین مدلهای هوش مصنوعی و برنامههای کلاینت. این مخزن مواد آموزشی جامع با مثالهای کد عملی در چندین زبان برنامهنویسی را فراهم میکند. این مخزن متمرکز بر مستندسازی است. بخش عمده راهاندازی در پروژهها و آزمایشگاههای نمونه جداگانه صورت میگیرد. پروژههای نمونه در مسیرهای زیر قرار دارند: - 03-GettingStarted/samples/ - مثالهای خاص زبان - 03-GettingStarted/01-first-server/solution/ - پیادهسازیهای سرور اول…