Quick entry points:

- `AGENTS.md` (guardrails + Done) - `docs/ai-playbook/index.md` (1-page navigation) - `docs/ai-playbook/code-map.md` (where to change) - `docs/ai-playbook/flows.md` (how the system runs) - `docs/ai-playbook/collab-rules.md` (plan-first template)

Two questions I’d love input on:

1. What’s your most effective “Done” / acceptance criteria format for coding agents? 2. Where do you put hard red-lines (security/privacy/architecture) so they actually get followed?

The repo includes templates for:

- `AGENTS.md` guardrails + Done criteria - A 1-page index - A code map - Key flows - A plan-first change template (mini design doc)

It’s meant to be copied into any repo and used as a default workflow for Claude/Codex-style agents.

I’d love feedback on what you’ve found actually works to keep agents aligned, and what you think is missing/overkill here.

Links:

- Repo: https://github.com/david-bai00/PrivyDrop - Write-up: https://www.privydrop.app/en/blog/ai-collaboration-playbook

Comments URL: https://news.ycombinator.com/item?id=46398957

Points: 2

# Comments: 1

I'm a C++ algorithms engineer, and today I'd like to share my first full-stack web project: PrivyDrop.

This project was born from two ideas:

First, I wanted to solve a daily annoyance of mine: I needed a simple, AirDrop-like way to send text, links, or screenshots between my phone and PC. I tried many tools, but they either required me to sign up, had various limitations, or uploaded my data to their servers, which I was never comfortable with.

Second, this was a personal experiment. Last year, with all the talk about "AI replacing programmers," I got curious. As a developer with no web background, I wanted to see how long it would take to learn full-stack development from scratch (an area I'm really interested in) and build a complete application, using AI as my primary coding partner and mentor.

PrivyDrop is the result of that learning and experiment.

It's a peer-to-peer (P2P) file-sharing tool based on WebRTC. Its core principle is that *your data belongs only to you*: all files and text are transferred directly between your browser and the recipient's, fully end-to-end encrypted, without ever passing through an intermediate server.

*Here are some of its key features:*

* Completely free and open-source, with no ads. * No sign-up or installation required—just open your browser. * Direct P2P connection for privacy, security, and speed. * No limits on file size or type. * Support for entire folder transfers. * Built-in resumable transfers.

The whole process has been a fantastic learning journey. I'm sharing it now in the hope that it can solve the same pain point for others. I'm really eager to hear any feedback, ideas, or even harsh criticism from the HN community!

* *Live Demo:* https://www.privydrop.app * *GitHub Repo:* https://github.com/david-bai00/PrivyDrop

Thanks, everyone!

Comments URL: https://news.ycombinator.com/item?id=45028261

Points: 16

# Comments: 0

What it does:

- Direct P2P file/text/folder sharing using WebRTC - No file size limits (only constrained by local disk space) - No registration required - All data stays on your devices (no server storage) - Supports multiple simultaneous receivers - Custom retrieval IDs and QR codes for easy sharing - Works across platforms, mobile-optimized

Technical details:

- Built with Next.js + Tailwind + shadcn/ui - Backend: Node.js + Redis (minimal, only for signaling) - WebRTC for direct P2P connections - DTLS encryption for all transfers - Files stream directly to disk

Background: I'm a C++ algorithm engineer and father of two who built this in my spare time over 4 months while learning full-stack development. Used AI pair programming extensively, which was an interesting learning experience.

I'd love feedback from the HN community. What features would make this more useful for your workflow?

Comments URL: https://news.ycombinator.com/item?id=42530448

Points: 9

# Comments: 0