Radar Live
✦ Ask AI
AI INTELLIGENCE & SIGNALS

Show HN: ArchDocs – Shared context and verification for engineers and AI agents

Phân tích đã xử lý trước và các nguồn liên quan.

Tín hiệu Radar

59 RADAR
Agents Agent Context & Verification · 1 nguồn đối chiếu · 2026-11-02 17:44:32 +0000 UTC

Show HN: ArchDocs – Shared context and verification for engineers and AI agents

Nguồn: Hacker News AI
↗

ArchDocs ra mắt tính năng Design Docs nhằm giải quyết bài toán thiếu ngữ cảnh lịch sử và thiếu cơ chế xác thực đáng tin cậy khi lập trình bằng AI agent. Nền tảng cho phép người dùng và agent cùng xây dựng spec, lập kế hoạch triển khai, ghi chép nhật ký công việc (work log) để chia sẻ các phát hiện lỗi giữa các agent tiếp theo, hỗ trợ tính năng bàn giao (handoff) và cung cấp cơ chế xác thực đa tầng (gồm agent/human attested và xác thực độc lập tự động qua GitHub checks).

✦ TÁC ĐỘNG & GIÁ TRỊ THỰC TIỄN

Việc thiếu ngữ cảnh lịch sử và thiếu cơ chế kiểm chứng kết quả độc lập là rào cản lớn khiến AI coding agent dễ lặp lại sai lầm và lãng phí token trong các dự án phức tạp. ArchDocs cung cấp giải pháp tài liệu thiết kế sống và quy trình xác thực có cấu trúc, giúp chuẩn hóa việc cộng tác và bàn giao công việc giữa con người và AI agent.

Developer 69
Business 60
Novelty 60
Actionable 75

Nội dung thu thập đã chuẩn hóa

Collected Evidence

Nội dung văn bản được dùng làm dữ liệu đối chứng cho mô hình AI, không phải chỉ thị hệ thống.

Hi HN, My name is Aylon and I'm building ArchDocs. I started building ArchDocs in late 2024 as an architecture diagramming tool with reusable references and objects (still exists today and is usable). As I've been using AI to code more and more, one of the things I've run into is that my agent doesn't have enough context around past decisions or findings that could affect an implementation, causing some nasty side-effects like redundant investigations, incorrect assumptions, repeating previously caught mistakes and ultimately wasting precious tokens. Let's say for example, you need to do a migration that affects 10 backend services. Your agent starts working on the first one and during the implementation and verification process, it discovers an issue that will undeniably affect the other 9 services. The next agent can start on the second service without knowing what was learned on the first. There's another problem I run up against time and time again. I need a dependable way to verify and log what an agent has done, the outcome of that and any deviations or issues that arise from it, so I can tell whether the change actually did what I intended. Enter Design Docs inside ArchDocs. The workflow is simple. You or your agent can craft a spec and ask questions for people to answer. Writing the implementation plan comes next, followed by doing the actual work. While you or your agent works, you track important milestones, deviations, decisions and more in the work log. Need to pause or have someone else do the work? No problem, craft a handoff or let ArchDocs AI do it for you. Finally, you or your agent logs a summarized version of what was done and how it was verified in an evidence of work submission. In that migration example, your agent can mark the issue in the work log as a "finding" and that will then be surfaced when future agents execute on the other 9 services. On the verification side, you may ask, "How does this help if the agent or engineer is just writing down their verification?" This is a good question and that's only one part of the verification. We have this concept of Agent attested (paired with human verified) and human attested. The last pillar and the most important is ArchDocs' own independent, automated verifications. Right now, we just have GitHub tracking for check results but we will soon be expanding this into so much more. Imagine one of the automated verifications is that a specific log with a specific attribute shows up in Datadog. Maybe even a specific event showing up in PostHog. There's a lot of ways we're going to take this and we're excited to share them once done. You can explore an example design doc without signing up. It includes the spec, implementation plan, work log and verification evidence: https://archdocs.io/templates/design-doc-example Comments URL: https://news.ycombinator.com/item?id=50340570 Points: 2 # Comments: 0

Các nguồn đối chiếu cho sự kiện này

1 nguồn
Thông tin phân tích AI & Model Details ▾
Provider: openai-compatible · Model: gemini-3.8-flash-high · Version: analysis-v1 · Time: 2026-11-03 01:14:27 +0000 UTC
{"tags": ["AI Agents", "Context Sharing", "Software Architecture", "Design Docs", "Verification", "Agent Handoff", "Developer Tools"], "risks": ["Phụ thuộc vào độ chính xác và tính đầy đủ khi agent hoặc kỹ sư ghi chép work log và findings.", "Tính năng kiểm tra tự động độc lập hiện mới chỉ dừng ở mức GitHub checks, các tích hợp sâu như Datadog hay PostHog vẫn ở lộ trình tương lai.", "Tạo thêm chi phí token và độ trễ nếu agent phải đọc/ghi tài liệu thiết kế liên tục.", "Dự án ở giai đoạn khởi đầu (Show HN sớm), chưa có nhiều kiểm chứng thực tế trên diện rộng."], "category": "Agents", "entities": ["ArchDocs", "Aylon", "GitHub", "Datadog", "PostHog", "Hacker News"], "summary_vi": "ArchDocs ra mắt tính năng Design Docs nhằm giải quyết bài toán thiếu ngữ cảnh lịch sử và thiếu cơ chế xác thực đáng tin cậy khi lập trình bằng AI agent. Nền tảng cho phép người dùng và agent cùng xây dựng spec, lập kế hoạch triển khai, ghi chép nhật ký công việc (work log) để chia sẻ các phát hiện lỗi giữa các agent tiếp theo, hỗ trợ tính năng bàn giao (handoff) và cung cấp cơ chế xác thực đa tầng (gồm agent/human attested và xác thực độc lập tự động qua GitHub checks).", "key_changes": ["Bổ sung tính năng Design Docs vào nền tảng ArchDocs nhằm chia sẻ ngữ cảnh và lưu vết quyết định giữa kỹ sư và AI agent.", "Chu trình làm việc chuẩn hóa gồm: viết spec, lập kế hoạch thực thi, theo dõi tiến độ qua work log và ghi nhận bằng chứng hoàn thành (evidence of work).", "Cơ chế lưu lại 'findings' trong work log để tự động hiển thị cho các agent kế tiếp, tránh trùng lặp điều tra và lãng phí token khi xử lý các bài toán quy mô lớn (như migration nhiều service).", "Hỗ trợ tính năng bàn giao công việc (handoff) tự động bằng ArchDocs AI hoặc thủ công giữa người và agent.", "Mô hình xác thực 3 trụ cột: Agent attested (kèm xác nhận của người), Human attested và Automated verification độc lập (hiện hỗ trợ GitHub check results, dự kiến tích hợp Datadog và PostHog)."], "sub_category": "Agent Context & Verification", "novelty_score": 60, "business_score": 60, "research_score": 40, "why_it_matters": "Việc thiếu ngữ cảnh lịch sử và thiếu cơ chế kiểm chứng kết quả độc lập là rào cản lớn khiến AI coding agent dễ lặp lại sai lầm và lãng phí token trong các dự án phức tạp. ArchDocs cung cấp giải pháp tài liệu thiết kế sống và quy trình xác thực có cấu trúc, giúp chuẩn hóa việc cộng tác và bàn giao công việc giữa con người và AI agent.", "developer_score": 75, "importance_score": 65, "possible_use_cases": ["Thực hiện các tác vụ di chuyển (migration) hoặc tái cấu trúc (refactoring) trên nhiều service, chia sẻ bài học kinh nghiệm từ service đầu sang các service sau.", "Lưu vết quyết định kiến trúc, ghi nhận các sai lệch (deviations) và bằng chứng xác thực trong quá trình AI agent can thiệp vào codebase.", "Bàn giao tiến độ thực thi giữa AI agent và kỹ sư khi gặp vấn đề phức tạp hoặc cần chuyển giao ca làm việc.", "Kiểm thử và xác thực tự động hành vi của agent thông qua GitHub Checks và log giám sát hệ thống."], "actionability_score": 75}
← Trang trước Trang 1