Lean orientation doc for future Claude Code instances. States the three surfaces (Flutter app, Go sidecar/CLI, pql as supporter), summarizes the guardrails as one-liners with pointers into ADRs 0001-0004, lists the tier ordering so new work doesn't skip ahead, and names the parent projects (legacy/ for Python clide, the discarded claudian experiment that contributed the architectural patterns, pql as the active supporter). Commands section is a placeholder until the Makefile lands in the next commit. Orientation, not a decision log — rationale lives in the ADRs. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.9 KiB
2.9 KiB
Changelog
All notable changes to clide are documented in this file.
The format follows Keep a Changelog 1.1.0, and this project adheres to Semantic Versioning.
This changelog tracks the Flutter rebuild at the repo root. The Python
Textual implementation's changelog is preserved under
legacy/CHANGELOG.md.
Versions are tracked in project.yaml under version:,
which is the single source of truth. Cutting a release means (a) moving
the entries below from ## [Unreleased] under a new dated version
heading, and (b) bumping project.yaml version: in the same commit.
[Unreleased]
Changed
.gitignorerewritten for the new toolchain: Flutter (build output underapp/), Dart (.dart_tool/), Go sidecar (sidecar/bin/,sidecar/dist/, the legacy/clidebinary), plus the usual test/OS/editor/secret rules. Python-specific rules narrow tolegacy/**where they still apply.
Added
- Architectural decision records carried forward from the short-lived
claudianplugin project (discarded in favour of this Flutter rebuild): ADR 0001 — CLI-first, not MCP. ADR 0002 — Sidecar language: Go. ADR 0003 — pql as supporter tool; wrap, don't duplicate; pql is a Clide subsystem when present. ADR 0004 — Ignore file strategy (ignore_files:in.pql/config.yaml, layered). - Project identity files for the Flutter rebuild at the repo root:
project.yaml(single source of truth for version + module path, version 2.0.0-dev), a freshREADME.md, MITLICENSE, and.editorconfig. The Python clide's manifest and README are preserved underlegacy/. docs/initial-plan.md— the north-star design document for the Flutter rebuild. Captures what we kept from Python Clide (pane model, git skills, Claude-always-visible), what we took from Obsidian (canvas and graph — no vault, no bases, no plugin inheritance), what Claudian's short experiment contributed (Go sidecar, CLI-first, pql-as-subsystem, ignore-file strategy), and the tier roadmap (Tier 0 app+sidecar handshake → Tier 5 canvas+graph).CLAUDE.mdorientation doc for future Claude Code instances: project identity, guardrails as one-liners, tier ordering, parent-project pointers, commands, dependencies & supply chain, open questions. Points at the design doc and ADRs rather than restating their content.- Claude Code configuration under
.claude/: project-level allow/deny permissions and two skills —skill-create(generic skill authoring guidance) andgit-commit(this repo's commit conventions: no Conventional Commits, Keep a Changelog discipline,project.yaml-and-changelog-bumped-together rule, attribution trailer, safety reminders).