docs: reframe techdocs for agentic AI workflows and 2024 whitepaper#539
Open
docs: reframe techdocs for agentic AI workflows and 2024 whitepaper#539
Conversation
Highlights Accord Project's three-component architecture (Markdown text, Concerto schema, TypeScript logic) as natively suited to AI agent workflows, while preserving the human/legal framing that matters to lawyers. Changes: - Homepage: restored original hero tagline with a new subtitle capturing the human+machine duality; rewrite feature cards to hold both the legal drafter and the machine/agent perspective; add "Built for Agent Workflows" section linking to the new AI guide and whitepaper; add whitepaper to the ecosystem strip. Fix navbar duplicate title, ecosystem contrast, content block alignment, and dark/light background alternation. - docs/accordproject-ai.md (new): dedicated AI & Agent Workflows guide covering why Markdown, TypeScript, and Concerto Schema each suit agent workflows, APAP/MCP tooling, and academic research citations. - docs/accordproject.md: reframe Lawyers section to lead with AI collaboration rather than blockchain; add AI agent paragraph for Developers. - docs/accordproject-slc.md: add "Machine-Legible to AI Agents" subsection with whitepaper quotes and academic citations. - docs/tutorial-hyperledger.md: upgrade deprecated notice to archived, redirect to APAP for modern integrations. - website/sidebars.js: add accordproject-ai to Introduction category. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/accordproject-ai.md— dedicated AI & Agent Workflows guide explaining why Markdown, TypeScript, and Concerto Schema are each natively suited to agent workflows; covers APAP/MCP tooling and links to academic research and the 2024 whitepaper.docs/accordproject.md— Lawyers section rewritten to lead with AI collaboration and drop the throwaway "blockchain" mention; Developers section gains an AI agent + APAP/MCP paragraph.docs/accordproject-slc.md— New "Machine-Legible to AI Agents" subsection with whitepaper quotes and academic citations.docs/tutorial-hyperledger.md— Deprecated notice upgraded to Archived with a forward pointer to APAP for modern integrations.website/sidebars.js—accordproject-aiadded to the Introduction category (third, after Smart Legal Contracts).Motivation
Recent advances in agentic AI make the three-component Accord Project template architecture (Markdown text / Concerto schema / TypeScript logic) more relevant than ever — but the existing docs don't make that connection. This revision surfaces that story prominently, references the 2024 whitepaper throughout, and deprioritises blockchain references (without erasing history) in line with the project's current direction.
Reviewer notes
accordproject-faq.md; the existing "blockchain is optional" answer there is good positioning and was left intact.🤖 Generated with Claude Code