greenpill-dev-guild/coop

آخر نشاط مصدر مسجل: ٢٧ مايو ٢٠٢٦ في ٠٢:٣٧

آخر تحديث لفهرس SkillsMP: ٢٩ أكتوبر ٢٠٢٦ في ١٨:٣٠

skills مجمعة: ٤٠

نجوم GitHub: ٣
تفرعات GitHub: ١

التثبيت بمساعدة مساعد ذكي

انسخ هذا الطلب إلى المساعد الذكي الذي تستخدمه.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/greenpill-dev-guild/coop.

ملف README للمستودع

مصدر ملف README للمستودع: README.md

قراءة الملف الأصلي

عرض ملف README كاملًا

# Coop ![Coop cover banner: no more chickens running loose](./docs/assets/branding/coop-cover-banner.png) **A browser-first, local-first extension and companion receiver PWA for capture, review, local AI refinement, and shared coop memory.** Coop helps groups capture what would otherwise get lost -- open tabs, voice memos, photos, files, and links -- then review, refine, and publish what matters. The extension is the main product surface. The companion PWA handles mobile and secondary-device capture. Core capture, review, local AI refinement, and private intake stay in the browser, with a small signaling/API layer for peer discovery and optional Yjs document sync. A coop is the shared group workspace and memory layer: reviewed drafts, published artifacts, board views, and proof material become visible to members only after human review. ## Current Status Coop is currently strongest as a browser-first staged-launch product. - Implemented today: browser capture and review, receiver pairing and private intake sync, local AI refinement, and shared coop publishing. - Gated or advanced: Safe/onchain behavior, live archive delegation, privacy modes, Green Goods workflows, and session-capability rails. - Validation: release readiness is tracked in the reference docs and validation commands below. ## How It Works 1. **Capture** -- Round up browser tabs with the extension. Record audio, take photos, attach files, or share links through the receiver PWA. 2. **Refine** -- A local in-browser agent and inference cascade turn captured context into candidates, drafts, and next steps without a hosted inference backend. 3. **Review** -- Members review candidates and drafts in the popup and `Chickens` before anything becomes shared coop state. 4. **Share** -- Publish reviewed drafts into the coop feed, sync through the local-first Yjs layer, and export board, proof, archive, or receipt material when needed. ## Main Surfaces - `Popup` -- quick capture, quick review, create/join flows, and feed access. - `Chickens` -- candidates, drafts, review queue, and publish prep. - `Coops` -- shared coop state, board/proof access, and archive-related actions. - `Roost` -- Green Goods member workspace in the current UI. - `Nest` -- members, receiver pairing, operator controls, and settings. - `Receiver` -- mobile and secondary-device capture surface. ## Key Features Implemented today: - **Capture and intake** -- Browser tabs in the extension; audio, photos, files, and links in the receiver PWA; paired mobile captures land in private intake before review. - **Review and publish** -- Popup and `Chickens` workflows for candidate review, draft editing, categorization, and publish decisions. - **Local AI refinement** -- A 16-skill agent pipeline with WebGPU, WASM, and heuristic tiers. - **Local-first sync** -- Yjs CRDT sync with y-webrtc peers, y-websocket document sync support, and outbox tracking for publish-related events. - **Board, proof, and export paths** -- Board views, archive receipts, snapshot/artifact export, and receipt export are surfaced today. - **Passkey-first identity** -- WebAuthn identity with no wallet-extension-first requirement. Gated or advanced: - **Onchain rails** -- Safe/ERC-4337 flows, anchor actions, and account-abstraction behavior are mock-first by default and move behind a live gate when intentionally enabled. - **Archive live rails** -- Storacha/Filecoin-backed archive delegation exists, but live credentials and trusted-node behavior are operator paths. - **Privacy modes** -- Baseline privacy is local-first capture and explicit publish. Anonymous publish and stealth-address UI are opt-in surfaces. - **Green Goods workflows** -- Member work intake, operator approvals, assessments, GAP reconciliation, and Hypercert/Karma GAP packaging depend on mode, authority, and environment. - **ERC-8004 / FVM registry** -- Agent identity and registry flows exist as gated infrastructure, not baseline first-run behavior. ## Architecture Bun monorepo with four runtime packages, plus docs and contracts sidecars: | Package | Description | |---------|-------------| | `@coop/shared` | Schemas, flows, sync contracts, and domain modules | | `@coop/app` | Landing page and receiver PWA shell | | `@coop/extension` | MV3 browser extension: popup, sidepanel, background handlers, offscreen workers | | `@coop/api` | Hono + Bun signaling relay with optional Yjs document sync persistence | Supporting directories: - `docs/` -- Docusaurus workspace for `docs.coop.town`. - `packages/contracts/` -- Foundry sidecar for Solidity contracts and deployment artifacts. Build order: shared -> app -> extension. ## Key Principles - **Browser-first** -- The extension is the primary product surface. - **Local-first** -- Raw captures stay on your device until explicit publish or sync. - **Passkey-first** -- No wallet extension is required for first-run identity. - **Offline capable** -- Core capture and review work without internet; sync resumes when connected. - **Explicit sharing** -- Review and publish remain human decisions. ## Local Development Coop pins Node 22 in `.mise.toml`. Bun is the workspace package manager, while the docs site still depends on a working Node toolchain. Recommended shell bootstrap: ```bash mise install eval "$(mise activate zsh)" node -v ``` `node -v` should report `v22.x` before you run docs commands. Essential commands: ```bash bun install # Install dependencies bun run dev # Start full repo-native local environment bun run dev:stop # Stop repo-tracked local targets bun run dev:app # Start app only bun run dev:extension # Start extension only bun run dev:api # Start API server bun run test # Run unit tests with Vitest bun run build # Build shared -> app -> extension bun run validate smoke # Fast confidence pass bun run validate:store-readiness ``` Always use `bun run test`, not `bun test`. Bun's built-in runner ignores the repo's Vitest config. ## Environment Use a single `.env.local` at the repository root. Do not create package-specific `.env` files. | Variable | Description | Default | |----------|-------------|---------| | `VITE_COOP_CHAIN` | Target chain: `sepolia` or `arbitrum` | `sepolia` | | `VITE_COOP_ONCHAIN_MODE` | Onchain mode: `mock` or `live` | `mock` | | `VITE_COOP_ARCHIVE_MODE` | Archive mode: `mock` or `live` | `mock` | | `VITE_COOP_SESSION_MODE` | Session mode: `off`, `mock`, or `live` | `off` | | `VITE_COOP_PRIVACY_MODE` | Privacy-mode surfaces such as anonymous publish UI | `off` | | `VITE_COOP_SIGNALING_URLS` | Comma-separated WebSocket signaling endpoints | `wss://api.coop.town` | | `VITE_COOP_RECEIVER_APP_URL` | Receiver PWA base URL | `http://127.0.0.1:3001` | | `VITE_PIMLICO_API_KEY` | Live Safe/ERC-4337 operations | -- | For Playwright E2E runs, the repo starts its own local signaling server automatically. ## Release / Validation Default release work stays on the deterministic mock-first path unless live rails are intentionally being exercised. - Common bar: `bun run test`, `bun run build`, `bun run validate smoke`, and `bun run validate:store-readiness`. - Broader release bar: `bun run validate:production-readiness`. - Live rails gate: `bun run validate:production-live-readiness`. - Public extension candidates should keep onchain, archive, and session modes on default mock/off settings unless the live gate is the explicit task. ## Documentation - [Current Release Status](docs/reference/current-release-status.md) - [Testing & Validation](docs/reference/testing-and-validation.md) - [Demo & Deploy Runbook](docs/reference/demo-and-deploy-runbook.md) - [Architecture](docs/builder/architecture.md) - [Environment Reference](docs/builder/environment.md) - [Receiver Pairing & Intake](docs/reference/receiver-pairing-and-intake.md) - [Extension Install & Distribution](docs/reference/extension-install-and-distribution.md) - [Live Rails Operator Runbook](docs/reference/live-rails-operator-runbook.md) ## Project Foundation & Brand Coop is built for community coordination work where context, evidence, governance, and capital formation need to stay connected without centralizing raw context on a server-first platform. The product uses chicken metaphors throughout. Open browser tabs are **Loose Chickens**. The review queue is **Chickens**. The shared feed is the **Coop Feed**. Creating a new shared space is **Launching the Coop**. The success chime is the **Rooster Call**. <p align="center"> <img src="./docs/assets/branding/coop-logo-square.png" alt="Coop logo" width="180"> </p>

جارٍ تحميل ملف README للمستودع…

Skills في هذا المستودع

مطوّرو البرمجيات محللو ضمان جودة البرمجيات والمختبرون المحررون ضباط الامتثال

١٥ فئات مهنية · 100% مصنفة

skill

المهنة

الوصف

آخر تحديث

coop-dev-surface

مطوّرو البرمجيات

Use when working in Coop and needing the local app, receiver PWA, docs, API/signaling server, or extension watcher.

لغة النص الأصلي: الإنجليزية

2026-05-27

browser-verification

مطوّرو الويب

Browser and visual verification for Coop app, extension, popup, sidepanel, and receiver flows. Use when UI changes need rendered proof, console inspection, screenshots, Playwright checks, or local browser debugging.

لغة النص الأصلي: الإنجليزية

2026-05-17

debug

مطوّرو البرمجيات

Debugging & Troubleshooting - systematic root cause investigation with hypothesis testing and evidence collection. Use when the user reports a bug, encounters an error, sees unexpected behavior, or says 'debug this' or 'investigate this issue'.

لغة النص الأصلي: الإنجليزية

2026-05-17

monitor

محللو ضمان جودة البرمجيات والمختبرون

Quality gate and regression monitor. One-shot (`/monitor`) or continuous (`/loop 5m /monitor`). Scope with --tests, --build, or run all checks by default.

لغة النص الأصلي: الإنجليزية

2026-05-17

performance

مطوّرو البرمجيات

Performance profiling and optimization - bundle analysis, Lighthouse CI, React Profiler, memory leaks, service worker cache efficiency. Use for performance investigations, optimization, and budget enforcement.

لغة النص الأصلي: الإنجليزية

2026-05-17

plan

متخصصو إدارة المشاريع

Planning & Execution - create structured implementation plans, check progress, execute in batches, manage lifecycle. Use when the user says 'plan this', asks to break down a feature into steps, or needs a phased implementation strategy before coding.

لغة النص الأصلي: الإنجليزية

2026-05-17

review

محللو ضمان جودة البرمجيات والمختبرون

Code Review & PR Creation - 6-pass systematic review covering correctness, security, performance, patterns, testing, and documentation. Use when reviewing a PR, auditing code changes, or the user asks for systematic code quality analysis.

لغة النص الأصلي: الإنجليزية

2026-05-17

testing

محللو ضمان جودة البرمجيات والمختبرون

Testing patterns - TDD workflow, Vitest unit tests, Playwright E2E, mock strategies, and coverage targets. Use when writing tests, setting up test infrastructure, following TDD, or diagnosing test failures.

لغة النص الأصلي: الإنجليزية

2026-05-17

skill-authoring

مطوّرو البرمجيات

Create and maintain repo-local skills from repeated workflows, recurring corrections, and durable agent guidance. Use when adding a new skill, updating an existing skill, distilling a conversation into a skill, or auditing skill/index/registry drift.

لغة النص الأصلي: الإنجليزية

2026-05-16

grant-action-planner

جامعو التبرعات

Plan the next action for the top-scored grant opportunity using a Gemma 4 function call.

لغة النص الأصلي: الإنجليزية

2026-05-15

review-digest

المحررون

Produce a weekly-style synthesis draft from accepted drafts and recent shared artifacts.

لغة النص الأصلي: الإنجليزية

2026-05-15

tab-router

مطوّرو البرمجيات

Route newly captured extracts into local coop contexts, preserve weak matches, and seed local drafts for stronger matches.

لغة النص الأصلي: الإنجليزية

2026-05-15

theme-clusterer

مطوّرو البرمجيات

Cluster related local signals into reusable themes for shared memory and coordination.

لغة النص الأصلي: الإنجليزية

2026-05-15

grant-fit-scorer

محللو أبحاث السوق ومتخصصو التسويق

Score extracted opportunities against coop purpose, rituals, and archive history.

لغة النص الأصلي: الإنجليزية

2026-05-15

opportunity-extractor

متخصصو العمليات التجارية، جميع الآخرون

Extract ecological, community, and capital-formation opportunity candidates from local knowledge.

لغة النص الأصلي: الإنجليزية

2026-05-15

capital-formation-brief

محللو التمويل والاستثمار

Synthesize high-fit opportunities into a concise review draft for funding and capital formation.

لغة النص الأصلي: الإنجليزية

2026-05-07

entity-extractor

علماء البيانات

Extract POLE+O entities (Person, Organization, Location, Event, Object) and relationships from ingested source content.

لغة النص الأصلي: الإنجليزية

2026-05-07

knowledge-lint

مطوّرو البرمجيات

Audit knowledge graph health: detect orphan entities, stale sources, contradictions, and coverage gaps.

لغة النص الأصلي: الإنجليزية

2026-05-07

memory-insight-synthesizer

مطوّرو البرمجيات

Synthesize newly routed local signals and memory into local-only insight drafts or digests for a coop.

لغة النص الأصلي: الإنجليزية

2026-05-07

status

مديرو أنظمة الحاسوب والمعلومات

Morning briefing — architecture state, feature pipeline, production health, user journeys, git pulse, and daily focus recommendations. Not an audit; a lay of the land.

لغة النص الأصلي: الإنجليزية

2026-05-07

design

مصممو واجهات الويب والرقمية

Design philosophy for Coop's adaptive, warm, browser-first interfaces. Four-lens framework: Regenerative, Spatial, Ecosystem, Compliance. Vellum material language. Progressive disclosure. Use for design direction, visual decisions, component planning, and…

لغة النص الأصلي: الإنجليزية

2026-04-06

architecture

مطوّرو البرمجيات

Analyze software architecture — map current structure, identify gaps, and provide actionable suggestions. Also serves as a patterns reference for Clean Architecture, DDD, and entropy reduction.

لغة النص الأصلي: الإنجليزية

2026-04-05

error-handling-patterns

مطوّرو البرمجيات

Robust error handling strategies for graceful failures and debugging. Use for error handling implementations, error flow debugging, error boundaries, retry mechanisms, and user-friendly error messages.

لغة النص الأصلي: الإنجليزية

2026-04-05

audit

مطوّرو البرمجيات

Codebase Audit - dead code detection, unused exports, architectural anti-patterns, and dependency health. Use when the user asks for a codebase health check, wants to find dead code, or says 'audit the codebase'.

لغة النص الأصلي: الإنجليزية

2026-04-05

principles

مطوّرو البرمجيات

Software engineering principles audit — SOLID, DRY, KISS, YAGNI, SOC, EDA, ADR, C4, ACID, BASE, CAP. Use when the user wants to check adherence to industry best practices or says 'principles audit'.

لغة النص الأصلي: الإنجليزية

2026-04-05

react

مطوّرو البرمجيات

React patterns - component architecture, state management (Zustand, XState), hook composition, and render performance. Use when building React components, managing state with Zustand, composing hooks, or diagnosing re-render performance issues.

لغة النص الأصلي: الإنجليزية

2026-04-05

security

محللو أمن المعلومات

Application security - passkey credentials, Safe multisig, extension runtime, signaling server, receiver HMAC, archive encryption, session keys, permits, agent pipeline, invite codes, CRDT integrity, stealth addresses, ZK proofs. Use for security reviews,…

لغة النص الأصلي: الإنجليزية

2026-04-01

ecosystem-entity-extractor

علماء الجغرافيا

Identify organizations, places, watersheds, bioregions, networks, and programs from local knowledge.

لغة النص الأصلي: الإنجليزية

2026-03-27

publish-readiness-check

المحررون

Review a draft for publish readiness and optionally propose a bounded publish action.

لغة النص الأصلي: الإنجليزية

2026-03-26

commit

مطوّرو البرمجيات

Organize and commit changes into logical thematic groups following conventional commit format. Use when the user says 'commit this', has many uncommitted changes, or wants to create well-structured commits.

لغة النص الأصلي: الإنجليزية

2026-03-24

erc8004-feedback

مطوّرو البرمجيات

Submit reputation feedback to ERC-8004 after archive anchor or peer sync success.

لغة النص الأصلي: الإنجليزية

2026-03-21

erc8004-register

مطوّرو البرمجيات

لغة النص الأصلي: الإنجليزية

2026-03-21

green-goods-assessment

ضباط الامتثال

Prepare a deterministic Green Goods assessment attestation from a structured assessment request.

لغة النص الأصلي: الإنجليزية

2026-03-21

green-goods-gap-admin-sync

مطوّرو البرمجيات

Align Karma GAP project admins with the current trusted coop operators for a linked garden.

لغة النص الأصلي: الإنجليزية

2026-03-21

green-goods-garden-bootstrap

مطوّرو البرمجيات

Bootstrap a Green Goods garden for a coop Safe using the coop's name, purpose, and Green Goods defaults.

لغة النص الأصلي: الإنجليزية

2026-03-21

green-goods-garden-sync

مطوّرو البرمجيات

Sync a linked Green Goods garden so its profile, domains, and signal pools match the coop state.

لغة النص الأصلي: الإنجليزية

2026-03-21

green-goods-work-approval

ضباط الامتثال

Prepare a deterministic Green Goods work approval attestation from a structured approval request.

لغة النص الأصلي: الإنجليزية

2026-03-21

data-layer

مطوّرو البرمجيات

Local-first data layer - Dexie (IndexedDB), Yjs (CRDT sync), y-webrtc (peer transport), storage quotas, draft persistence. Use for local persistence, peer sync, offline features, and storage design.

لغة النص الأصلي: الإنجليزية

2026-03-16

ui-compliance

مطوّرو الويب

UI compliance - WCAG 2.1 AA accessibility, form validation patterns, responsive layouts, and animation best practices. Use when building or reviewing components for accessibility compliance, form UX, mobile-first responsive design, or motion preferences.

لغة النص الأصلي: الإنجليزية

2026-03-13

web3

مطوّرو البرمجيات

Web3 frontend patterns - viem, Safe SDK, permissionless (ERC-4337), passkey auth, transaction lifecycle. Use for Safe operations, account abstraction, passkey identity, and onchain interactions.

لغة النص الأصلي: الإنجليزية

2026-03-13

عرض ٤٠ من أصل ٤٠ skills مجمعة.