Integrate koni-docs standard#5000
Open
saltict wants to merge 62 commits into
Open
Conversation
Brainstorming output for ai-development branch. Covers scope decomposition (1 of 3 sub-tasks), file inventory, content shape, execution workflow, risks, and out-of-scope items deferred to sub-task 2 (docs content) and sub-task 3 (issue migration).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Author
|
🚀 Deployed on https://pr-5000--sw-web-runner.netlify.app |
Adapted from multica-ai/andrej-karpathy-skills CLAUDE.md. Adds 4 rules (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) at the top so AI agents see them before project-specific context. Existing sections renumbered 1-10 -> 2-11; no content changes.
saltict
changed the title
… and remove logo image
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
WAVE 4/5 subgraphs reused ids W4/W5 as node ids, breaking the Mermaid render. Rename the nodes to W4N/W5N and update the wave classDef list. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Phase 3 header read "Bitcoin, Cardano, Multi-chain Ecosystem" but its entries (D26-D30) are all swap/XCM scope decisions: cancel dynamic swap pairs, cancel 1inch, stay on ParaSpell, migrate ParaSpell v1, remove the Crowdloans tab. Retitle to "Swap/XCM Consolidation & Feature Pruning" so the phase name matches the decisions it groups. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Phase 2 header said "Earning, Swap, and Multi-chain Expansion" but it has no swap decision (those are Phase 3) and omitted D21 Texterify (i18n) and D22 Meld (fiat on-ramp). Retitle to "Earning Rebrand, XCM Bridge, i18n & Fiat Tooling" so the name covers D20-D25. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Intake-B only flagged explicitly-worded decisions, so major integrations (BTC, TON, Cardano, Bittensor, proxy, multisig) had 0 CONTEXT entries despite being large feature areas — while trivial items like the Crowdloans removal were captured. Per the koni-docs definition (an architecture or scope decision / "why we picked X over Y"), mined the real architecture/scope decisions for those areas from issues/PRs/ comments and merged them with the existing 30. Result: 30 -> 59 decisions, renumbered D1-D59 chronologically, re-bucketed into 5 phases with content-accurate titles. New-decision versions resolved from the CHANGELOG issue->version map. All bodies preserved verbatim. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The AD table only had infra decisions (storage, ChainService, MV3, keyring, monorepo, XCM toggle, fork). The major chain integrations (Bitcoin, TON, Cardano, Bittensor) and account models (unified, proxy, multisig) had no AD entry despite being core architecture — the same gap just fixed in CONTEXT. Add AD-11..AD-19, each cross-referencing the CONTEXT decision(s) and source issues. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- Move chain-management above security; merge chain-abstraction into it - Split "DeFi & Governance" group into DeFi + Governance - New Utilities epic = onboarding + campaign + notification (FR-149) - Renumber every EPIC (1-19) and FR (1-161) by new document order - Re-sync 7 FR cross-references in CONTEXT.md - Record discussion notes (docs/notes/2026-06-11.md) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
ARCHITECTURE intro claimed "four ecosystems / 100+ networks", contradicting its own AD-11/AD-14 (Cardano) and the rest of the corpus (200+). AGENTS project purpose was also missing Cardano. - ARCHITECTURE.md: four -> five ecosystems (+ Cardano); 100+ -> 200+ networks - AGENTS.md: add Cardano to the supported-ecosystems list Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Pilot decomposition validating the koni-docs story/epic format across 3 groups: EPIC-3 (account), EPIC-11 (swap), EPIC-16 (hardware-wallet). - epics/: FR Coverage tables fully numbered (US ids locked in FR order, no future renumber); Out-of-scope, cross-cutting invariants, stories tables. - stories/: 2 example story files per epic on the canonical template (Given/When/Then AC, TASK→AC refs, verification, changelog). Points grounded in the §3a-bis calibration scale, marked retroactive. - STATUS.md: auto-generated by `koni-docs status` (6 stories, backlog). - notes/2026-06-11.md: clarify B6 as pilot/example only, not a rule. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
PRD: thin Epics & User Stories index (FR-centric), ✅/🚧/📋 status key, and status corrections (FR-50/93/124/144/112 → planned, FR-99 TON, FR-117 LST text). ARCHITECTURE: fix NftService class name (was NFTService). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds 17 epics + completes the 3 pilots. Sections tiered by story count per the canonical epic template (Small/Medium/Large): Feature pillars + AD Coverage on Medium+, and §9 Object map / §13 Cross-story testing / §14 Performance budgets on Medium+ where applicable. Happy-path diagrams are shipped-only (no planned steps); grounded in real services (ChainService, EarningService, SwapService, KeyringService, RequestService, NftService, …). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
One story per FR (prd_ref → FR) plus per-epic hardening clusters (no FR). All status: backlog (Stream-B conversion phase); real shipped state lives in the PRD FR markers. Retroactive stories backfill commit/version_shipped in a later reconciliation pass. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Auto-generated via koni-docs status. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…giene to EPIC-1 AD-20 (four-state MV3 lifecycle) is owned by EPIC-1/US-1.1; EPIC-20 now marks it *referenced* (it refactors the lifecycle for perf, it doesn't own the contract), resolving the double-ownership with EPIC-1. US-20.7 (dependency auditability / supply-chain hygiene, NFR-19) was a junk-drawer fit in a performance epic — it rode EPIC-1's AD-05/AD-06 and shared no surface with the perf pillars. Folded into EPIC-1/US-1.5 as a 7th build/CI hardening theme and removed from EPIC-20 (7 -> 6 stories); NFR-19 PRD pointer now -> US-1.5. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
EPIC-20 dropped to 6 stories after relocating supply-chain hygiene to EPIC-1. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Review round after sub-task 3: assignee identity-resolution + history backfill, koni-docs conformance gaps (5-layer/sprint/version drift), web-surface base epic, public/private multi-repo governance, recurring-task skills, and a docs/knowledge research layer proposal. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Add §L (master→main, subwallet-dev→dev cutover: CI, artifact names, webapp/ web-runner build re-org, propagate to Mobile + Chainlist) and reorder §K. Concrete task breakdown deferred until the review meeting finalizes scope. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…map plan - Strip all references to Branch rename and ERP-critical path - Collapse from 6 waves to 5, removing the rename wave - Update dependency diagram, gantt chart, and wave summary accordingly - Keep existing branches unchanged for stability
…ries - Create EPIC-21 (Docs & Conformance Infrastructure) with 3 stories: - US-21.1: Contributor identity map - US-21.2: History backfill - US-21.3: Conformance close-out - Add gap stories from subwallet-dev merge: - US-8.13: Payload decode error handling (#4989) - US-4.24: Remove Polygon zkEVM (#5002) - US-12.17: Earning term & condition display (#5007) - Update EPIC-4, EPIC-8, EPIC-12 story tables and PRD - Regenerate STATUS.md (175 stories)
…-21.2 - Create sprint-2026-W28.md with EPIC-21 scope (3 stories) - Assign US-21.1 → assignee: tunghp2002, status: in-progress; US-21.2/21.3 → assignee: tunghp2002 - Update US-21.2 Background/ACs/Dev notes for sprint archive and monthly naming - Remove archive/ references and sprint-YYYY-MNN convention per user feedback - Regenerate STATUS.md (175 stories)
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
2 participants
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
koni-docsskill fromKoniverse/Koni-Skillsinto the monorepo (skills-lock.json+.agents/skills/koni-docs/).AGENTS.md(canonical AI agent guide — single source of truth for Cursor / Gemini / Codex CLI / Claude Code).CLAUDE.md(thin pointer to AGENTS.md + Koni-Docs Integration YAML block + Active Context).VERSIONfile (1.3.79, synced with rootpackage.json)..active-context.example.md(per-developer Pattern B template); gitignore.active-context.md.This is sub-task 1 of 3 on the
ai-developmentumbrella. Out of scope (separate PRs to follow):docs/content (BRIEF / PRD / ARCHITECTURE / CONTEXT / LESSONS / SETUP / sprints / CHANGELOG).Spec & plan
docs/superpowers/specs/2026-06-02-koni-docs-integration-design.mddocs/superpowers/plans/2026-06-02-koni-docs-integration-sub-task-1.mdTest plan
npx skills experimental_installreproduces.agents/skills/koni-docs/fromskills-lock.json(round-trip MATCH, byte-for-byte identical).active-context.mdis gitignored (git check-ignoreconfirms rule at.gitignore:49)<MONOREPO_TABLE_ROWS>,<TODO>,XXX-FIXME,fill in→ no matches)yarn install --immutablesucceeds (~10 s, lockfile unchanged)yarn koni-dev-build-ts(TypeScript build) succeeds## Koni-Docs Integrationblock parses as valid YAML with expected fields (plugins: [],docs_path: docs/,active_sprint: <TBD-after-sub-task-2>,version_file: VERSION)package.json(fixed in commit76ff80b6f0— original draft had 4 fabricatedwebpack:*aliases; replaced with real script namesbuild:ui,watch-dev,webapp:dev,webapp:build, plus 2 newweb-runnerrows)Known deferred items
docs/CHANGELOG.md.packages/*use version1.3.79-1(with-1monorepo internal suffix);VERSIONuses1.3.79(root). Reconciliation deferred to sub-task 2.active_sprint:inCLAUDE.mdis<TBD-after-sub-task-2>— no active sprint until sub-task 2 starts one.yarn run lintOOMs locally on the implementing machine due to a pre-existing heap limit; this is unrelated to this PR (CI is expected to run lint successfully).Brainstorming + plan trail
Implementation followed the Superpowers brainstorming → writing-plans → subagent-driven-development flow. Spec + plan files are committed in
docs/superpowers/. Every task went through two-stage review (spec compliance → code quality) before its commit was accepted. The only review iteration was Task 6 → fix commit76ff80b6f0(Section 4 fabricated commands).🤖 Generated with Claude Code