[codex] Improve README showcase and docs task lifecycle

.agents/skills/change-implementation-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: change-implementation-plan
-description: Use when drafting, revising, or persisting an implementation plan for a feature, bug fix, refactor, documentation update, or other repository change. Guides agents to write English plans with Background, Goals, Implementation Plan, Acceptance Criteria, and Validation Commands, and to save every implementation plan under docs/plans/ with a timestamped filename.
+description: Use when drafting, revising, or persisting an implementation plan for a feature, bug fix, refactor, documentation update, or other repository change. Guides agents to write English plans with Background, Goals, Implementation Plan, Acceptance Criteria, and Validation Commands, and to save every implementation plan under the appropriate docs/tasks lifecycle folder with a timestamped filename.
 ---
 
 # Change Implementation Plan
@@ -11,7 +11,12 @@ This skill is for implementation planning. Do not use it for GitHub issue drafti
 
 ## Persistence Rule
 
-Every implementation plan must be saved under `docs/plans/`.
+Every implementation plan must be saved under the appropriate `docs/tasks/` lifecycle folder.
+
+- Use `docs/tasks/backlog/` for planned work that has not started.
+- Use `docs/tasks/doing/` for active implementation work.
+- Use `docs/tasks/done/` for completed work.
+- Use `docs/tasks/trash/` for abandoned or superseded work.
 
 Name the file with a 24-hour timestamp prefix:
 
@@ -91,7 +96,7 @@ Write the plan in English using these sections, in this order:
 
 Before returning or saving the plan, check:
 
-- The file is saved under `docs/plans/` with a timestamped filename.
+- The file is saved under the correct `docs/tasks/` lifecycle folder with a timestamped filename.
 - The plan includes `Background`, `Goals`, `Implementation Plan`, `Acceptance Criteria`, and `Validation Commands`.
 - Optional Background subsections are used only when they improve clarity.
 - Acceptance criteria describe outcomes, not internal implementation steps.

.gitignore

@@ -10,6 +10,8 @@
 .history
 .cache/
 .idea/
+.antigravitycli/
+.agents/skills/source-command-opsx-*/
 
 # IntelliJ/Melos generated files
 *.iml

AGENTS.md

@@ -6,9 +6,11 @@
 - Run mobile app Flutter tests from the package directory: `cd apps/mobile_chat_app && flutter test` (avoid `flutter test apps/mobile_chat_app` from repo root).
 - Never pass Markdown files (for example `*.md`) to `dart format` or other Dart source-only tooling commands; target only Dart files/directories.
 
-## Plan persistence
-- For each feature or task, create and save a markdown plan file in `docs/plans/`.
-- Name plan files with a `YYYY-MM-DD-HH-mm` prefix using 24-hour time (optionally appending a timezone such as `-UTC`).
+## Task lifecycle
+- For each feature or task, create and save a markdown task file under `docs/tasks/`.
+- Use the lifecycle folders: `docs/tasks/backlog/` for planned or not-yet-started work, `docs/tasks/doing/` for active work, `docs/tasks/done/` for completed work, and `docs/tasks/trash/` for abandoned or superseded work.
+- Name task files with a `YYYY-MM-DD-HH-mm` prefix using 24-hour time (optionally appending a timezone such as `-UTC`).
+- Do not add new files to the legacy plan/backlog folders; use `docs/tasks/` instead.
 
 ## Worktree task workflow
 - The repository may contain a top-level `.worktree/` directory for storing local git worktrees.

README.md

@@ -2,9 +2,46 @@
 
 **The agent console for tinkerers.**
 
-- Connect your OpenClaw and run multiple agent threads side by side
-- Manage your todo lists and data tables (like Notion) through conversation
-- Fully open-source: frontend, backend, iOS, and Android
+Bricks helps you run AI work across conversations, OpenClaw nodes, and durable workspace resources.
+
+## What Bricks does today
+
+- Capture useful information from chat as todos, tables, notes, and highlights
+- Keep different topics separated with channels and threads, like Discord
+- Connect OpenClaw and route messages to specific agent nodes
+- Configure AI model providers, channel instructions, thread instructions, and node tokens
+- Automate recurring agent tasks on a schedule
+- Fully open source: Flutter app, Node backend, mobile clients, docs, and plugin runtime
+
+## What you can save
+
+Bricks keeps useful information available after the chat moves on.
+
+- **Todo Lists** - Project checklists, follow-up tasks, meeting actions, and homework plans.
+- **Tables** - Comparison matrices, research trackers, lead lists, bug triage, and planning data.
+- **Notes** - Research summaries, reusable instructions, generated reports, study notes, and specs.
+- **Highlights** - Important facts, decisions, quotes, references, and snippets worth keeping.
+
+## Showcase
+
+### Topic-based agent work
+
+![Bricks channel and thread workspace](docs/assets/showcase/chat-knowledge-organization.png)
+
+### Saved highlights and notes
+
+![Bricks resources for highlights and notes](docs/assets/showcase/resources-highlights.png)
+
+## What's on the roadmap
+
+- Richer note content, including purpose-specific charts, diagrams, and examples
+- Grammar issue collection for review, reuse, and analysis
+- Website artifacts for saving generated pages and interactive previews
+- Charts for turning structured data into visual summaries
+- Motion outputs for animation, timing, and visual storytelling
+- GitHub integration for issues, pull requests, and repository workflows
+
+[Tell us your story or request a feature](https://github.com/askman-dev/bricks/issues/new)
 
 ## Documentation
 

apps/docs_site/sidebars.ts

@@ -34,11 +34,11 @@ const sidebars: SidebarsConfig = {
     },
     {
       type: 'category',
-      label: 'Plans',
+      label: 'Tasks',
       items: [
-        'plans/2026-04-26-10-20-UTC-docusaurus-doc-ia-restructure',
-        'plans/2026-04-21-07-57-UTC-readme-refresh-consolidated-plan',
-        'plans/2026-04-08-02-40-UTC-code-map-foundation',
+        'tasks/done/2026-04-26-10-20-UTC-docusaurus-doc-ia-restructure',
+        'tasks/done/2026-04-21-07-57-UTC-readme-refresh-consolidated-plan',
+        'tasks/done/2026-04-08-02-40-UTC-code-map-foundation',
       ],
     },
   ],

docs/code_maps/logic_map.yaml

@@ -23,10 +23,10 @@ index:
       - tools/evidence/channel_dropdown_height/run.sh
       - tools/evidence/channel_dropdown_height/channel_dropdown_flow.mjs
     doc_index:
-      - docs/plans/2026-05-20-11-13-CST-local-cloud-db-debug.md
-      - docs/plans/2026-05-21-10-41-CST-channel-new-ui-harness.md
-      - docs/plans/2026-05-21-12-03-CST-evidence-checkpoint-testing-docs.md
-      - docs/plans/2026-05-21-12-38-CST-local-manual-ai-test-env-docs.md
+      - docs/tasks/done/2026-05-20-11-13-CST-local-cloud-db-debug.md
+      - docs/tasks/done/2026-05-21-10-41-CST-channel-new-ui-harness.md
+      - docs/tasks/done/2026-05-21-12-03-CST-evidence-checkpoint-testing-docs.md
+      - docs/tasks/done/2026-05-21-12-38-CST-local-manual-ai-test-env-docs.md
       - docs/testing/local-chat-fixture-db.md
       - docs/testing/evidence-checkpoint-browser-harness.md
       - docs/testing/local-manual-ai-test-env.md
@@ -127,26 +127,26 @@ index:
       - docs/architecture.md
       - docs/architecture/system-overview.md
       - openspec/changes/multi-agent-participation/design.md
-      - docs/plans/2026-04-18-00-20-UTC-openclaw-message-routing-current-state.md
-      - docs/plans/2026-04-23-17-13-WIB-openclaw-agents-capture-display.md
-      - docs/plans/2026-04-23-15-33-openclaw-selected-node-routing.md
-      - docs/plans/2026-04-24-12-15-dispatch-avatar-placeholder.md
-      - docs/plans/2026-04-26-02-45-UTC-jump-to-latest-message.md
-      - docs/plans/2026-04-26-02-45-dark-theme-semantic-token-refactor.md
+      - docs/tasks/done/2026-04-18-00-20-UTC-openclaw-message-routing-current-state.md
+      - docs/tasks/done/2026-04-23-17-13-WIB-openclaw-agents-capture-display.md
+      - docs/tasks/done/2026-04-23-15-33-openclaw-selected-node-routing.md
+      - docs/tasks/done/2026-04-24-12-15-dispatch-avatar-placeholder.md
+      - docs/tasks/done/2026-04-26-02-45-UTC-jump-to-latest-message.md
+      - docs/tasks/done/2026-04-26-02-45-dark-theme-semantic-token-refactor.md
       - docs/kb/color-theme-architecture.md
       - .codex/skills/bricks-design-system/SKILL.md
-      - docs/plans/2026-04-26-23-24-+08-chat-dark-colors.md
-      - docs/plans/2026-04-27-00-19-+08-design-system-token-alignment.md
-      - docs/plans/2026-04-27-00-27-+08-design-system-skill.md
-      - docs/plans/2026-04-27-17-28-UTC-markdown-table-rendering.md
-      - docs/plans/2026-05-15-16-21-+08-chat-scroll-position-gwt.md
-      - docs/plans/2026-05-15-16-54-+08-local-chat-fixture-db.md
-      - docs/plans/2026-05-16-17-58-+08-mobile-agents-directory-setup-fix.md
-      - docs/plans/2026-05-16-23-21-+08-ios-sandbox-path-without-home.md
-      - docs/plans/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
-      - docs/plans/2026-05-19-14-27-CST-tool-call-thinking-group.md
-      - docs/plans/2026-05-19-17-38-CST-subsection-rename-menu.md
-      - docs/plans/2026-05-21-10-41-CST-channel-new-ui-harness.md
+      - docs/tasks/done/2026-04-26-23-24-+08-chat-dark-colors.md
+      - docs/tasks/done/2026-04-27-00-19-+08-design-system-token-alignment.md
+      - docs/tasks/done/2026-04-27-00-27-+08-design-system-skill.md
+      - docs/tasks/done/2026-04-27-17-28-UTC-markdown-table-rendering.md
+      - docs/tasks/done/2026-05-15-16-21-+08-chat-scroll-position-gwt.md
+      - docs/tasks/done/2026-05-15-16-54-+08-local-chat-fixture-db.md
+      - docs/tasks/done/2026-05-16-17-58-+08-mobile-agents-directory-setup-fix.md
+      - docs/tasks/done/2026-05-16-23-21-+08-ios-sandbox-path-without-home.md
+      - docs/tasks/done/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
+      - docs/tasks/done/2026-05-19-14-27-CST-tool-call-thinking-group.md
+      - docs/tasks/done/2026-05-19-17-38-CST-subsection-rename-menu.md
+      - docs/tasks/done/2026-05-21-10-41-CST-channel-new-ui-harness.md
       - docs/testing/local-chat-fixture-db.md
     test_index:
       - apps/mobile_chat_app/test/chat_arbitration_engine_test.dart
@@ -285,8 +285,8 @@ index:
       - apps/node_backend/src/services/chatRouterService.ts
       - apps/node_backend/src/db/migrations/013_add_instructions_to_chat_scope_settings.sql
     doc_index:
-      - docs/plans/2026-04-30-17-51-+08-scope-instructions-config.md
-      - docs/plans/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
+      - docs/tasks/done/2026-04-30-17-51-+08-scope-instructions-config.md
+      - docs/tasks/done/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
     test_index:
       - apps/mobile_chat_app/test/chat_history_api_service_test.dart
       - apps/node_backend/src/services/chatRouterService.test.ts
@@ -320,7 +320,7 @@ index:
       - apps/node_backend/src/services/chatRouterService.ts
       - apps/node_backend/src/db/migrations/013_add_instructions_to_chat_scope_settings.sql
     doc_index:
-      - docs/plans/2026-04-30-17-51-+08-scope-instructions-config.md
+      - docs/tasks/done/2026-04-30-17-51-+08-scope-instructions-config.md
     test_index:
       - apps/mobile_chat_app/test/chat_history_api_service_test.dart
       - apps/node_backend/src/services/chatRouterService.test.ts
@@ -357,7 +357,7 @@ index:
       - docs/model_settings_plan.md
       - docs/architecture.md
       - docs/openclaw_pull_only_integration_dev_doc.md
-      - docs/plans/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
+      - docs/tasks/done/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
     test_index:
       - apps/mobile_chat_app/test/model_settings_screen_test.dart
       - apps/mobile_chat_app/test/llm_config_service_test.dart
@@ -391,7 +391,7 @@ index:
     doc_index:
       - docs/product/overview.md
       - docs/integrations/openclaw-plugin.md
-      - docs/plans/2026-04-21-00-12-UTC-multi-node-plugin-implementation.md
+      - docs/tasks/done/2026-04-21-00-12-UTC-multi-node-plugin-implementation.md
     test_index:
       - apps/mobile_chat_app/test/node_settings_screen_test.dart
       - apps/node_backend/src/routes/config.test.ts
@@ -427,7 +427,7 @@ index:
       - docs/product/overview.md
       - docs/faq/common-issues.md
       - docs/architecture.md
-      - docs/plans/2026-05-19-17-06-CST-navigation-resources-highlights.md
+      - docs/tasks/done/2026-05-19-17-06-CST-navigation-resources-highlights.md
     test_index:
       - apps/mobile_chat_app/test/app_test.dart
       - apps/mobile_chat_app/test/chat_navigation_page_test.dart
@@ -502,11 +502,11 @@ index:
       - docs/integrations/openclaw-plugin.md
       - docs/architecture.md
       - docs/openclaw_pull_only_integration_dev_doc.md
-      - docs/plans/2026-04-18-00-20-UTC-openclaw-message-routing-current-state.md
-      - docs/plans/2026-04-23-17-13-WIB-openclaw-agents-capture-display.md
-      - docs/plans/2026-04-23-15-33-openclaw-selected-node-routing.md
-      - docs/plans/2026-05-06-22-42-+08-router-strategy-rename.md
-      - docs/plans/2026-05-06-22-44-+08-post-router-refactor-followup.md
+      - docs/tasks/done/2026-04-18-00-20-UTC-openclaw-message-routing-current-state.md
+      - docs/tasks/done/2026-04-23-17-13-WIB-openclaw-agents-capture-display.md
+      - docs/tasks/done/2026-04-23-15-33-openclaw-selected-node-routing.md
+      - docs/tasks/done/2026-05-06-22-42-+08-router-strategy-rename.md
+      - docs/tasks/done/2026-05-06-22-44-+08-post-router-refactor-followup.md
       - apps/node_backend/src/routes/platform.test.ts
       - apps/node_backend/src/routes/config.test.ts
       - apps/node_backend/src/services/chatRouterService.test.ts
@@ -565,7 +565,7 @@ index:
       - docs/faq/common-issues.md
       - docs/openclaw_pull_only_integration_dev_doc.md
       - docs/plugin_development_architecture.md
-      - docs/plans/2026-04-23-17-13-WIB-openclaw-agents-capture-display.md
+      - docs/tasks/done/2026-04-23-17-13-WIB-openclaw-agents-capture-display.md
       - apps/node_openclaw_plugin/README.md
       - apps/node_openclaw_plugin/openclaw.plugin.json
     test_index:
@@ -601,7 +601,7 @@ index:
       - docs/intro.md
       - docs/get-started/quickstart.md
       - docs/product/overview.md
-      - docs/plans/2026-04-26-12-19-docs-subpath-vercel-integration.md
+      - docs/tasks/done/2026-04-26-12-19-docs-subpath-vercel-integration.md
     test_index:
       - tools/vercel-build.sh
     keywords:
@@ -629,8 +629,8 @@ index:
       - apps/mobile_chat_app/lib/features/chat/todo_api_service.dart
       - apps/mobile_chat_app/lib/services/authenticated_api_client.dart
     doc_index:
-      - docs/plans/2026-05-16-02-20-+00-todos-tables-highlights-tools.md
-      - docs/plans/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
+      - docs/tasks/done/2026-05-16-02-20-+00-todos-tables-highlights-tools.md
+      - docs/tasks/done/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
     test_index:
       - apps/node_backend/src/services/localAgentLoopService.test.ts
     keywords:
@@ -663,7 +663,7 @@ index:
       - apps/mobile_chat_app/lib/features/chat/chat_message.dart
       - apps/mobile_chat_app/lib/services/authenticated_api_client.dart
     doc_index:
-      - docs/plans/2026-06-16-15-32-+08-note-content-type-implementation.md
+      - docs/tasks/done/2026-06-16-15-32-+08-note-content-type-implementation.md
       - docs/tasks/done/2026-06-12-14-00-+08-note-content-type.md
     test_index:
       - apps/node_backend/src/routes/resources.test.ts
@@ -703,9 +703,9 @@ index:
       - apps/mobile_chat_app/lib/features/chat/asset_table_api_service.dart
       - apps/mobile_chat_app/lib/services/authenticated_api_client.dart
     doc_index:
-      - docs/plans/2026-05-16-02-20-+00-todos-tables-highlights-tools.md
-      - docs/plans/2026-05-17-00-04-+08-table-tool-error-and-turso-compatibility.md
-      - docs/plans/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
+      - docs/tasks/done/2026-05-16-02-20-+00-todos-tables-highlights-tools.md
+      - docs/tasks/done/2026-05-17-00-04-+08-table-tool-error-and-turso-compatibility.md
+      - docs/tasks/done/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
       - docs/kb/turso-sqlite-compatibility.md
     test_index:
       - apps/node_backend/src/services/localAgentLoopService.test.ts
@@ -745,12 +745,12 @@ index:
       - apps/mobile_chat_app/lib/features/chat/chat_navigation_page.dart
       - apps/mobile_chat_app/lib/features/chat/widgets/message_list.dart
     doc_index:
-      - docs/plans/2026-05-16-02-20-+00-todos-tables-highlights-tools.md
-      - docs/plans/2026-05-18-22-22-+08-highlight-selection-offsets.md
-      - docs/plans/2026-05-19-10-50-+08-unified-authenticated-api-client.md
-      - docs/plans/2026-05-19-11-55-+08-highlight-toolbar-union-ranges.md
-      - docs/plans/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
-      - docs/plans/2026-05-19-17-06-CST-navigation-resources-highlights.md
+      - docs/tasks/done/2026-05-16-02-20-+00-todos-tables-highlights-tools.md
+      - docs/tasks/done/2026-05-18-22-22-+08-highlight-selection-offsets.md
+      - docs/tasks/done/2026-05-19-10-50-+08-unified-authenticated-api-client.md
+      - docs/tasks/done/2026-05-19-11-55-+08-highlight-toolbar-union-ranges.md
+      - docs/tasks/done/2026-05-19-13-02-CST-highlight-list-and-auth-api-architecture.md
+      - docs/tasks/done/2026-05-19-17-06-CST-navigation-resources-highlights.md
       - docs/design/text-highlight-floating-toolbar.design.md
     test_index:
       - apps/mobile_chat_app/test/message_list_test.dart
@@ -806,7 +806,7 @@ index:
       - apps/node_backend/src/app.ts
       - vercel.json
     doc_index:
-      - docs/plans/2026-05-26-18-34-CST-scheduled-actions-agent-execution.md
+      - docs/tasks/backlog/2026-05-26-18-34-CST-scheduled-actions-agent-execution.md
     test_index:
       - apps/node_backend/src/services/localAgentLoopService.test.ts
     keywords: