Commit Graph

141 Commits

Author SHA1 Message Date
liuzhengdong d7aa046a18 feat: skill优化 2026-07-25 21:17:33 +08:00
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 a2f9a0fe17 fix: 微调SKILL.md 的表述 2026-07-12 22:22:03 +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 48a24179fe release: codestable-lite 0.1.1 2026-07-06 17:46:56 +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 c5bd4b27ed refine: update documentation to emphasize core understanding without code references and enhance evidence indexing 2026-07-06 15:59:43 +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 f30c6cd139 refine: add guidelines for structured reporting after task completion 2026-07-01 09:28:13 +08:00
liuzhengdong 2ca196386c refine: update issue file naming convention to include status prefix 2026-07-01 07:53:36 +08:00
liuzhengdong c8b7ffd095 Require frontmatter for planned issues 2026-06-30 19:21:30 +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 fb578c4dee Add CodeStable operating principles 2026-06-30 08:51:11 +08:00
liuzhengdong 7f9c0a4152 Enhance clarity on inquiry practices in cs-talk and cs skills documentation 2026-06-29 22:30:07 +08:00
liuzhengdong 13d633da5c Consolidate LITE note and bug workflows 2026-06-29 21:41:04 +08:00
liuzhengdong b081c37dbc fix: 提交ignore 2026-06-29 21:26:08 +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 66b767f7ab Add CodeStable debug guidance 2026-06-28 16:53:19 +08:00
liuzhengdong df413e45be feature: 构建 cs-how-codedesign 架构设计指导原则
参照 codebase-design 的深模块思想,按 cs-how-* 体例独立重写。
同步更新 cs 导览中 codedesign(已落地)/onboard(规划中) 状态。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 16:42:58 +08:00
liuzhengdong 12440e69cd refactor: 删除旧两轴版 cs-onboard,待按 LITE 重做
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 16:17:01 +08:00
liuzhengdong 5921cb7941 refactor: 规整 cs 为体系导览,删除旧两轴技能
cs 从路由器改为 CodeStable(LITE) 体系导览,对齐 WHY CODESTABLE。
删除旧两轴技能:cs-audit/clarify/code/context/convention/doc-api/
doc-tutorial/epic/issue/keep/note。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 16:15:24 +08:00
liuzhengdong 1027c1be5a feature: 新增 cs-talk 与 cs-how-great-skills
cs-how-great-skills 立"什么是好技能"的尺子:技能=背景+原则+应用场景,
附自洽、短、原则多了归类三条横切要求。

cs-talk 按该尺子写成三部分:洞察真实诉求,不管出口、不写共识,
聊出的术语/约束由用户拆进 requirements。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-28 16:03:41 +08:00
liuzhengdong 0485cf59f1 feature: 开始重构codestable-lite 2026-06-28 15:14:55 +08:00
liuzhengdong 93e7ca1900 优化 2026-06-28 13:31:33 +08:00
liuzhengdong f4fb1c3739 继续优化 2026-06-28 13:31:27 +08:00
liuzhengdong b8983aa824 fix: 微调cs-note 2026-06-28 10:51:41 +08:00