docs: update README files for flipper packages

Revise documentation for @flippercloud/flipper, flipper-cache, and
flipper-redis to clarify installation steps, usage examples, and core
concepts. Refactor code samples to use modern import syntax and
JavaScript/TypeScript conventions. Improve explanations around cache
wrappers, adapters, and feature flag examples for better onboarding.
Streamline doc sections to focus on quick usage and relocate advanced
development setup to separate docs. Enhance links to comprehensive
guides for configuration and best practices.

Author: jonmagic

packages/flipper-cache/README.md

@@ -1,23 +1,33 @@
 # @flippercloud/flipper-cache
 
-Generic cache wrapper for Flipper TypeScript adapters, providing read-through and optional write-through caching.
+Generic cache wrapper for Flipper adapters, providing read-through and optional write-through caching for improved performance.
 
-## Install
+## Installation
 
 ```bash
 bun add @flippercloud/flipper-cache
 ```
 
 ## Quick usage
 
-```ts
+```typescript
+import Flipper from '@flippercloud/flipper'
 import Cache, { MemoryCache } from '@flippercloud/flipper-cache'
-const cached = new Cache(storeAdapter, new MemoryCache(), { ttlSeconds: 300, prefix: 'flipper:' })
+
+const storeAdapter = new YourAdapter() // e.g., RedisAdapter, SequelizeAdapter
+const cacheAdapter = new Cache(storeAdapter, new MemoryCache(), {
+  ttlSeconds: 300,
+  prefix: 'flipper:',
+})
+const flipper = new Flipper(cacheAdapter)
+
+await flipper.enable('cached-feature')
+const isEnabled = await flipper.isEnabled('cached-feature')
 ```
 
 ## Docs
 
-Looking for setup, options, custom backends, and best practices? See the full guide: [Cache adapter guide](../../docs/adapters/cache.md).
+Looking for cache backends, TTL configuration, and best practices? See the full guide: [Cache adapter guide](../../docs/adapters/cache.md).
 
 ## License
 

packages/flipper-redis/README.md

@@ -34,7 +34,7 @@ console.log(isEnabled) // true
 
 ## Docs
 
-Looking for setup options, clustering, read-only mode, data structures, and best practices? See the full guide: [Redis adapter guide](../../docs/adapters/redis.md).
+Looking for setup options, clustering, read-only mode, and best practices? See the full guide: [Redis adapter guide](../../docs/adapters/redis.md).
 
 ## License
 

packages/flipper/README.md

@@ -1,38 +1,40 @@
-# Flipper TypeScript
+# @flippercloud/flipper
 
-A TypeScript implementation of [Flipper](https://github.com/flippercloud/flipper) - a feature flagging library.
+A TypeScript/JavaScript implementation of [Flipper](https://github.com/flippercloud/flipper) - a feature flagging library for controlling features and behavior.
 
 ## Installation
 
 ```bash
-bun add flipper-typescript
+bun add @flippercloud/flipper
 ```
 
-## Development
+## Quick usage
 
-### Prerequisites
+```typescript
+import Flipper from '@flippercloud/flipper'
+import { MemoryAdapter } from '@flippercloud/flipper'
 
-- Node.js >= 18.0.0
-- Bun >= 1.3.2
+const adapter = new MemoryAdapter()
+const flipper = new Flipper(adapter)
 
-### Setup
+// Enable a feature
+await flipper.enable('new-ui')
 
-```bash
-bun install
+// Check if a feature is enabled
+const isEnabled = await flipper.isEnabled('new-ui')
+console.log(isEnabled) // true
+
+// Enable for specific actors
+await flipper.enableActor('premium-feature', 'user-123')
+
+// Check if enabled for a specific actor
+const isPremiumEnabled = await flipper.isEnabledFor('premium-feature', 'user-123')
+console.log(isPremiumEnabled) // true
 ```
 
-### Scripts
-
-- `bun run build` - Build the TypeScript source
-- `bun test` - Run tests
-- `bun run test:watch` - Run tests in watch mode
-- `bun run test:coverage` - Run tests with coverage
-- `bun run lint` - Lint code with ESLint
-- `bun run lint:fix` - Lint and auto-fix issues
-- `bun run type-check` - Check TypeScript types
-- `bun run format` - Format code with Prettier
-- `bun run format:check` - Check code formatting
-- `bun run clean` - Remove build artifacts
+## Docs
+
+Looking for configuration, adapters, advanced usage, and best practices? See the full guide: [Flipper documentation](../../docs/README.md).
 
 ## License