Skip to content

docs+objects: design proposal V1.0 (maintainer-confirmed), global-first, AI participation, Agiloft gap, roadmap - #1

Merged
hotlong merged 4 commits into
mainfrom
claude/design-proposal
Sep 7, 2026
Merged

hotlong merged 4 commits into
mainfrom
claude/design-proposal

Conversation

@hotlong

@hotlong hotlong commented Sep 7, 2026 •

Copy link
Copy Markdown
Contributor

What

Design proposal V0.10 (docs/design/00-设计方案.md) plus the object and blueprint changes it implies, after the maintainer's direction on 2026-09-07: design for global customers, say how AI is integrated, name the gap to Agiloft, and say how goals, requirements and work are managed.

  • Global-first. Sealing is no longer a module: clm_contract_type.requires_seal → execution_formalities (countersigned copy · company seal · notarized · witnessed); clm_seal_request → clm_signature (one execution record per signing round: method, provider, envelope, signers, formalities done). E-signature is the default (DocuSign first, Adobe Acrobat Sign and Dropbox Sign next); regional providers, local registry screening and seal circulation are region packs. clm_party gains country_code and sanctions/registry screening_status + screened_at. English is the default locale and source language; USD is the factory default currency; the demo company is a multi-entity group. Categories: labor → employment, dpa added.
  • AI participation — proposal §10, DESIGN.md §07: three governance principles (same permissions and audit as people · propose only, a person adopts · hidden without an AI runtime), three layers (skills, ai.exposed actions exposed over MCP, four ai_* fields written only by "adopt"), a six-capability map by lifecycle stage, the approver memo, governance rules.
  • Agiloft gap — proposal §11: twelve-row comparison; the gap concentrates in the document layer, the external surface and the integration catalogue (all platform dependencies); the places to lead are AI-native operation, open-source one-click install, and Ironclad-style intake.
  • Management model and roadmap — docs/README.md (roadmap · versioned design baseline · DESIGN.md · requirements triage · backlog → issues; why issues stay small) and docs/ROADMAP.md (0.1 → 2.x with buyer outcomes and platform dependencies).
  • Backlog cards, README, AGENTS.md and manifest updated to match. Positions 8 → 7, permission sets 6 → 5, sharing rules 7 → 6.

How to review

Read the proposal's §13 (表 15) and reply per item (16 items): 同意默认 / 改为 X / 删除. Items 8, 9, 11, 15 and 16 are the ones the global-first revision added or changed.

Gates

pnpm validate (4 objects, 52 fields) · pnpm lint · pnpm typecheck green on the head.

🤖 Generated with Claude Code

https://claude.ai/code/session_01KcrVDXSptwDukFsHPHPR1V

The complete business design in the house format used for KPI: one-page
summary, goals and scope, roles and data scope, the end-to-end process with
system guarantees, sixteen functional modules (contract types as workflows,
the launch form, legal review, the clause playbook, negotiation turns and
versions, the approval matrix with worked examples, signing and sealing,
obligations, payment schedules, amendments and renewals, expiry and
archive, counterparties, legacy import, the notification inventory,
dashboards and metric definitions, AI assistance), the object overview and
ER diagram, the state machine with its write-side guards, numbering and
routing rules, timing definitions, the permission matrix, integration
design (e-signature contract, HotCRM hand-off mapping), non-functional
baselines, fourteen decisions awaiting confirmation, milestones and the
scope ladder.

DESIGN.md stays the engineering authority; this document is the reviewable
narrative that expands it and must not contradict it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KcrVDXSptwDukFsHPHPR1V
…oadmap

Maintainer direction (2026-09-07): design for global customers, not
Chinese customers; say how AI is integrated; name the gap to Agiloft;
say how goals, requirements and work are managed; plan the roadmap.

- Sealing is no longer a module. `clm_contract_type.requires_seal` becomes
  `execution_formalities` (countersigned copy, company seal, notarized,
  witnessed); `clm_seal_request` becomes `clm_signature` — one execution
  record per signing round with method, provider, envelope, signers and
  the formalities done. E-signature is the default (DocuSign first, Adobe
  Acrobat Sign and Dropbox Sign next); regional providers are region packs.
- `clm_party` gains `country_code` and sanctions/registry `screening_status`
  + `screened_at` (replacing `verified_at`); registration label reads
  "Registration / Tax ID". Contract categories: `labor` → `employment`,
  `dpa` added. English is the default locale and source language; USD is
  the factory currency default; the demo company is a multi-entity group.
- DESIGN.md: §01 全球优先 constraints, §07 rewritten as the AI integration
  design (three layers, S1–S6 capability map, approver memo, MCP surface,
  governance rules, honest degradation), positions 8→7, sets 6→5, sharing
  rules 7→6, Q7 region-pack packaging.
- Design proposal V0.10: §2.1 global constraints, §5.7 signing and
  execution, new §10 AI 融合设计 and §11 与 Agiloft 的差距, decisions 14→16,
  chapters renumbered.
- docs/README.md: the four-layer management model (roadmap · versioned
  design baseline · DESIGN.md · requirements triage · backlog→issues) and
  why issues stay small. docs/ROADMAP.md: releases 0.1 → 2.x with buyer
  outcomes and platform dependencies.
- Backlog cards, README, AGENTS.md and manifest updated to match.

Gates: pnpm validate (4 objects, 52 fields), lint, typecheck green.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KcrVDXSptwDukFsHPHPR1V
@hotlong hotlong changed the title docs: add the HotCLM design proposal (V0.9, for review) docs+objects: design proposal V0.10 — global-first, AI participation, Agiloft gap, roadmap Sep 7, 2026
…iner

Maintainer, 2026-09-07: "16 项全部同意默认,升 V1.0 并派发 M1". The
proposal's §13 becomes 已确认口径 and V1.0 is the release-1 baseline.
DESIGN.md §13 records the same rulings (Q1–Q8) and lands the two that
change the model: contract numbers are hook-generated
`<type.code>-<YYYY>-<0000>` (Q5) and executed contracts can be backfilled
straight into `active` through the F16 `executed_upload` action with an
`is_backfilled` marker (Q8). Cards 02 and 09 carry those two items.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KcrVDXSptwDukFsHPHPR1V
@hotlong hotlong changed the title docs+objects: design proposal V0.10 — global-first, AI participation, Agiloft gap, roadmap docs+objects: design proposal V1.0 (maintainer-confirmed), global-first, AI participation, Agiloft gap, roadmap Sep 7, 2026
@hotlong
hotlong marked this pull request as ready for review September 7, 2026 11:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants