diff --git a/README.md b/README.md
index 5c6e47d..25a3ab3 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,26 @@
 # tiny-pattern-ts
+
+Pattern matching for TypeScript/ESM environments (F#-style, not regex).
+
+## Development
+
+- **Build:** `npm run build`
+- **Test:** `npm run test`, `npm run test:ci`
+- **Checks:** `npm run check`, `npm run fix`
+
+## VSCode integration
+
+- Debugging
+- Running tests
+
+## Workflows
+
+- Version updates
+- Changelog automation
+- Publishing
+
+## Contribution guidelines
+
+- Commit signing (GPG)
+- How to set up commit message template
+- Reference to commit-message-template