Commit Graph

55 Commits

Author SHA1 Message Date
liuzhengdong a93053864e feat: Introduce Vision Spec for organizing product goals and adaptive actions
- Added Vision Spec to capture the overarching application vision, allowing users to articulate their desired outcomes and candidate directions.
- Updated Talk mode to facilitate discussions around the Vision, enabling users to clarify and refine their product ideas without immediate pressure to implement.
- Enhanced templates for issues and epics to reference Vision, ensuring alignment between current development and long-term goals.
- Implemented a new directory structure for Vision-related documents, including vision-index and vision-section-index templates.
- Revised existing documentation to reflect the separation of Vision from Project Spec, emphasizing the importance of maintaining distinct boundaries between desired outcomes and current realities.
- Introduced guidelines for using Vision to support user journeys and product capabilities, allowing for a more structured approach to product development.
2026-07-16 23:35:04 +08:00
liuzhengdong c1a0e39aa5 feat: introduce UI visual specifications and enhance documentation
- Added a new `ui-spec.md` to define principles for UI visual specifications, including when to create visual specs and how to represent UI elements using ASCII wireframes and Mermaid diagrams.
- Updated README files to include sections on how UI specs utilize visuals, emphasizing the importance of visual representation in understanding UI requirements.
- Enhanced various skill references and templates to incorporate UI visual contracts, ensuring that UI changes are documented with appropriate visual aids.
- Implemented checks in the skill repository to ensure compliance with UI visual specification requirements across relevant documents and templates.
2026-07-15 22:30:57 +08:00
liuzhengdong cfd955e54e feat: Enhance implementation economy guidance and documentation
- Added implementation-economy guidance in README and translated README.en.md.
- Introduced economy.md to outline principles for maintaining economic implementation.
- Updated various templates to include references to bounded simplifications and upgrade triggers.
- Enhanced the check-skill-repository.py script to validate economy contracts.
- Revised multiple skill references to incorporate new economy principles and ensure clarity on quality objectives.
2026-07-15 22:20:13 +08:00
liuzhengdong 0ed674bff2 Enhance quality management in CodeStable framework
- Introduced a new quality.md reference document outlining the nine product quality characteristics based on ISO/IEC 25010:2023.
- Updated design, do, explore, talk, and spec documents to incorporate quality goals and commitments, ensuring they are part of the issue lifecycle.
- Modified templates for various issue types (bug, chore, feature, refactor) to include sections for quality objectives, ensuring that quality considerations are explicitly documented and addressed.
- Implemented checks in the skill repository to ensure quality objectives are included in relevant templates and that the quality.md is referenced appropriately.
- Enhanced the overall structure of documentation to emphasize the importance of quality in design decisions and implementation evidence.
2026-07-15 22:15:19 +08:00
liuzhengdong 9007cbd231 feat: redefine Explore around how it works 2026-07-12 23:53:22 +08:00
liuzhengdong 0ba5161aff Refactor documentation and templates for CodeStable
- Updated CLAUDE.md and README files to clarify skill independence and documentation structure.
- Removed facts.md template and integrated essential startup rules into AGENTS.md and CLAUDE.md.
- Revised various reference documents to enhance clarity on knowledge management and project specifications.
- Adjusted init_codestable.py script to eliminate facts.md creation and streamline project initialization.
- Introduced user preferences document to emphasize professional user treatment and technical depth.
- Ensured all changes align with the new structure for knowledge artifacts and project documentation.
2026-07-12 22:34:04 +08:00
liuzhengdong 90d76ce9bc refactor: distribute CodeStable as a standard skill 2026-07-12 21:16:12 +08:00
liuzhengdong 13bd92a2c4 feat: unify CodeStable into one cs skill 2026-07-12 21:03:44 +08:00
liuzhengdong 7ea1a0c273 feat: 更新 2026-07-09 21:25:17 +08:00
liuzhengdong ad270c38c3 refine: enhance clarity in cs-talk documentation and prompts for better user guidance 2026-07-06 18:48:46 +08:00
liuzhengdong 64dfe45128 Refine documentation and workflows for project spec, epic spec, and exploratory issues
- Enhanced README.md to clarify the closing rules for issues and the structure of exploratory issue workspaces.
- Updated SKILL.md for cs-close to specify the merging process for exploratory issues and their candidate articles.
- Improved SKILL.md for cs-how-docs to emphasize narrative usage and reader pathways in documentation.
- Revised SKILL.md for cs-plan to clarify the distinction between independent and exploratory issues.
- Modified SKILL.md for cs-spec-explore to detail the exploratory issue lifecycle and the structure of candidate articles.
- Introduced new templates for exploratory articles and indexes to standardize documentation within exploratory issue workspaces.
- Adjusted project spec and section index templates to focus on usage paths and capabilities rather than code structure.
- Enhanced cs-talk SKILL.md to ensure context reuse and effective questioning during discussions.
2026-07-06 17:31:44 +08:00
liuzhengdong 2b17afe92a refine: update documentation and templates for issue management, enhancing clarity on exploration and issue types 2026-07-06 16:45:01 +08:00
liuzhengdong 2ab09caa63 refine: update README and check-plugin-package.py with additional installation commands for local development and branch reference 2026-07-06 15:10:44 +08:00
liuzhengdong 2e1ce9a2fe refine: update design and implementation documentation to integrate testing strategies and remove obsolete test design references 2026-07-06 15:08:14 +08:00
liuzhengdong b974e7dd5f refine: update design entry descriptions and add design focus points for clarity 2026-07-06 14:46:33 +08:00
liuzhengdong c2a37e6c51 refine: update slug references to phrase in documentation and skills for consistency 2026-07-06 14:32:57 +08:00
liuzhengdong ce7010c9ca refine: update planning and design skills for clarity and user confirmation 2026-07-06 14:20:09 +08:00
liuzhengdong 111829d152 feat: add new skills and templates for CodeStable LITE
- Introduced `cs-spec` for maintaining project and epic specifications.
- Added `cs-spec-explore` for creating exploratory issues to investigate project spec gaps.
- Implemented `cs-talk` for clarifying vague ideas and organizing discussions.
- Created `cs-test` for optional test design associated with specific issues.
- Developed `cs` as a navigation skill to guide users on which CodeStable skill to use.
- Added various templates for project specifications, epic specifications, and exploratory issues.
- Implemented a validation script to check plugin package integrity and structure.
2026-07-06 14:10:46 +08:00
liuzhengdong 5ad300711a Remove outdated templates and introduce new structured templates for project specifications, exploration issues, and planning documentation. This update includes the deletion of legacy markdown files related to epics, issues, requirements, and notes, while adding new templates for tools, project specs, and exploration processes to enhance clarity and organization in documentation practices. 2026-07-06 13:55:24 +08:00
liuzhengdong 83ce3f913f feat: add cs-spec skill for progressive specification clarification
- Introduced `cs-spec` skill to handle upstream specification clarifications, allowing for iterative alignment of specs, code context, and blockers.
- Created a new directory structure under `.cs/specs/` to store specification-related documents.
- Updated existing skills (`cs-talk`, `cs-plan`) to reference the new `cs-spec` skill for improved workflow.
- Enhanced documentation across various skills to reflect the new specification handling process, including templates for spec documentation.
- Added new templates for spec findings, changes, flow, glossary, index, plan briefs, questions, and sources to standardize spec documentation.
- Updated `SKILL.md` files to include references to the new `cs-spec` skill and its functionalities.
2026-07-02 09:34:01 +08:00
liuzhengdong 279937a349 refine: update implementation design descriptions to tutorial-style for clarity and consistency 2026-07-02 07:58:42 +08:00
liuzhengdong 24d8656a8b Enhance documentation structure and clarity across multiple skills
- Added guidelines for adhering to `cs-how-docs` in various skills to improve document organization and reader navigation.
- Revised descriptions in `cs-design`, `cs-do`, `cs-complain`, `cs-close`, `cs-test`, `cs-wiki`, and `cs-plan` to emphasize the importance of context reuse and clear documentation paths.
- Introduced a new skill `cs-how-docs` to establish principles for organizing documentation as a knowledge space rather than flat content.
- Updated templates for issues and wiki topics to include structured sections for design conclusions, reader paths, and clear problem statements.
- Ensured that all skills now emphasize the need for confirming current versions of documents and facts before proceeding with tasks.
2026-07-02 07:51:25 +08:00
liuzhengdong b76ddacd74 Refactor and enhance documentation for CodeStable and Browser Bridge
- Updated cs-test and cs SKILL.md files to clarify testing design principles and guidelines.
- Improved organization and clarity in requirements documentation, including new templates for requirements and wiki topics.
- Introduced cs-wiki for automated wiki generation and requirements candidate documentation.
- Added Browser Bridge CLI documentation, including setup instructions and command usage.
- Created new agents for various functionalities including CS Code Design, CS Debug, and CS Talk.
- Established a structured approach for managing wiki questions and requirements drafts.
2026-07-01 14:48:51 +08:00
liuzhengdong 2ca196386c refine: update issue file naming convention to include status prefix 2026-07-01 07:53:36 +08:00
liuzhengdong 4bf91b99d4 refine: update cs-close description to include git commit process and related changes 2026-06-30 15:49:54 +08:00
liuzhengdong 13d633da5c Consolidate LITE note and bug workflows 2026-06-29 21:41:04 +08:00
liuzhengdong 2d2770a2ea Refine cs-talk context gap handling 2026-06-29 21:18:37 +08:00
liuzhengdong e693dca7b1 Refine CodeStable requirements guidance 2026-06-29 09:24:33 +08:00
liuzhengdong 561e8d3ecc Add CodeStable onboarding and workflow capture 2026-06-29 08:51:56 +08:00
liuzhengdong 5abc0b78c7 Expand CodeStable local issue workflow 2026-06-29 07:50:14 +08:00
liuzhengdong 635726f09b Refine CodeStable local planning flow 2026-06-28 17:52:02 +08:00
liuzhengdong aebe509d0b Add CodeStable entity references 2026-06-28 17:13:42 +08:00
liuzhengdong 93e7ca1900 优化 2026-06-28 13:31:33 +08:00
liuzhengdong f0dc28cd85 refactor: 重写入口/接入/周边技能、模板与 README 对齐两轴
cs 路由表改两轴;cs-onboard 骨架 context/+载体选择(github/local)+分发 convention;
cs-note/brainstorm/keep/doc-* 改引用并瘦身 <100 行;
system-overview/maintainer-notes/convention 模板重写;README 双语按两轴重写。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-27 08:47:19 +08:00
liuzhengdong 74f1aa3dee refactor: 精简 cs-* 体系——compound 四件套合一、外部文档改名、删 architecture 立 cs-domain
三刀连贯重构,让体系更符合"grill-me 风格、产物聚合在 .codestable/、人在环"的初衷:

第一刀(compound 四件套合一):
- 删 cs-learn / cs-trick / cs-decide / cs-explore,合并成 cs-keep
- compound 文件改纯 markdown 无 frontmatter,靠 grep 检索(淘汰 search-yaml 在 compound 上的角色)

第二刀(外部文档改名):
- cs-libdoc → cs-doc-api(不再绑死"库"语义,凡是 API 参考都适用)
- cs-guide → cs-doc-tutorial(明确是任务导向的 how-to / tutorial)

第三刀(删 architecture,立 cs-domain):
- 删 cs-arch 技能和 architecture/ 目录(长期实践证明是累赘而非资产)
- 新建 cs-domain 技能管 CONTEXT.md 术语 + adrs/ 架构决策(守门 3 判据 + Nygard 四节)+ 单/多 context 拓扑
- cs-feat-accept 的 Phase 5 从"代写架构 doc"改为"盘点领域影响 + 提示 cs-domain",越权问题自动消失
- cs-brainstorm 加横切:讨论拍板符合 ADR 3 判据就路由到 cs-domain

净变化:cs-* 技能 25 → 22;行数 +400 / −2000+
2026-06-25 21:30:03 +08:00
liuzhengdong 9216e88d17 Refactor CodeStable documentation and scripts for improved clarity and structure
- Removed unnecessary compiled Python files from __pycache__.
- Updated `search-yaml.py` to enhance filter syntax and usage examples, including support for OR logic in filters.
- Revised multiple SKILL.md files to clarify instructions, emphasizing the importance of reading `.codestable/attention.md` before proceeding with actions.
- Adjusted paths in documentation to consistently reference `.codestable/` instead of `codestable/`.
- Enhanced descriptions in requirement and roadmap documentation to better define the purpose and structure of each component.
- Improved clarity in the `cs-trick` documentation regarding the nature of the reference library and its usage.
- Ensured all references to tools and commands are consistent with the new directory structure.
2026-05-06 07:41:39 +08:00
liuzhengdong 3e87e3a87d feat: add Star History section to README for tracking repository popularity 2026-04-25 21:44:22 +08:00
liuzhengdong fba868e9f1 feat: add English README file for improved accessibility and documentation 2026-04-25 21:13:32 +08:00
liuzhengdong f628c7bf49 feat: Add root entry skill 'cs' for CodeStable workflow
- Introduced a new skill 'cs' as the unified entry point for CodeStable, providing an overview of the system and routing user requests to appropriate sub-skills.
- Updated README.md to include usage instructions for the new root entry command.
- Enhanced documentation in various skills (cs-roadmap, cs-feat-design, cs-onboard) to clarify the role of the 'cs' skill and its interactions with other components.
- Improved clarity on the roadmap structure, emphasizing the importance of architectural planning and interface contracts.
- Added detailed sections for module splitting and interface contracts in the roadmap documentation.
2026-04-24 20:52:18 +08:00
liuzhengdong 41106f1c74 feat: add visual comparison image and update constraints section in README.md 2026-04-24 07:49:46 +08:00
liuzhengdong 1af03ef342 feat: enhance README.md with promotional image and improve system overview clarity 2026-04-24 07:38:43 +08:00
liuzhengdong 933f0d967e feat: add compiler-driven refactoring principles documentation
feat: introduce humble component/controller split recipe

feat: implement outward move recipe for extracting composables

feat: create thin composable purification recipe
2026-04-24 07:18:13 +08:00
liuzhengdong 817f5f6815 refactor: update README.md for clarity and structure, enhancing workflow descriptions and design philosophy 2026-04-23 07:48:25 +08:00
liuzhengdong e98448b04d Refactor project structure and naming conventions from easysdd to codestable
- Updated SKILL.md files to reflect new naming conventions and project structure.
- Changed references from easysdd to codestable in various documentation files.
- Adjusted paths for requirements, roadmap, and tricks to align with the new structure.
- Ensured consistency across all related documents and references.
2026-04-23 07:40:34 +08:00
liuzhengdong 525b143752 feat: add easysdd-roadmap skill and reference documentation
- Introduced `easysdd-roadmap` skill to manage large feature requests by breaking them down into sub-features with dependencies and statuses.
- Created `SKILL.md` to outline the purpose, usage scenarios, and workflow of the `easysdd-roadmap` skill.
- Added a reference template in `reference.md` for the main document and items.yaml format used in the roadmap.
- Established a clear directory structure for organizing roadmap documents and their associated items.
- Defined rules for single target management, dependency handling, and validation processes to ensure clarity and consistency in roadmap creation.
2026-04-23 07:20:59 +08:00
liuzhengdong 42e597e66d refactor: clarify checklist generation process in shared conventions 2026-04-21 23:00:30 +08:00
liuzhengdong ec015370db refactor: update README.md for improved clarity and structure; enhance project rationale and workflow descriptions 2026-04-20 07:29:26 +08:00
liuzhengdong 27a1be334a Delete outdated reference documents on external reporting, peer communication, upward reporting, and writing to sell skills to streamline content and improve clarity. 2026-04-19 21:57:46 +08:00
liuzhengdong 775f0cd1d3 Refactor SKILL.md and related files to use {slug} prefix for consistency
- Updated all references in SKILL.md files across easysdd-feature-implement, easysdd-feature, easysdd-issue-analyze, easysdd-issue-fix, easysdd-issue-report, easysdd-issue, easysdd-learning, easysdd-onboarding to replace 'design.md', 'checklist.yaml', 'report.md', 'analysis.md', and 'fix-note.md' with '{slug}-design.md', '{slug}-checklist.yaml', '{slug}-report.md', '{slug}-analysis.md', and '{slug}-fix-note.md' respectively.
- Ensured that all documentation reflects the new naming conventions for better clarity and organization.
- Adjusted validation scripts and templates to accommodate the new file naming structure.
2026-04-17 17:56:32 +08:00
liuzhengdong 65f0a12c13 refactor: rename easysdd-compound to easysdd-learning and update related documentation
- Updated the name and description in SKILL.md to reflect the new focus on learning documentation.
- Adjusted references throughout the onboarding process to point to the new easysdd/compound directory for learning resources.
- Modified the search tools and commands to align with the new directory structure and naming conventions.
- Ensured all relevant documentation templates and examples are updated to use the new naming scheme.
- Enhanced clarity on the purpose of each document type within the easysdd framework.
2026-04-17 15:30:54 +08:00