Merge pull request #572 from objectstack-ai/copilot/scan-code-and-plan-roadmap

Author: hotlong

ARCHITECTURE.md

@@ -674,6 +674,8 @@ export type Field = z.infer<typeof FieldSchema>;
 
 - [Quick Reference Guide](./QUICK-REFERENCE.md) - Fast lookup for common tasks
 - [Package Dependency Graph](./PACKAGE-DEPENDENCIES.md) - Complete dependency visualization
+- [Development Roadmap](./ROADMAP.md) - Next-phase optimization & improvement plan
+- [Studio Roadmap](./apps/studio/ROADMAP.md) - Studio IDE development plan
 - [MicroKernel Architecture Guide](./content/docs/developers/micro-kernel.mdx)
 - [Plugin Ecosystem Architecture](./content/docs/developers/plugin-ecosystem.mdx)
 - [Writing Plugins](./content/docs/developers/writing-plugins.mdx)
@@ -682,6 +684,6 @@ export type Field = z.infer<typeof FieldSchema>;
 
 ---
 
-**Last Updated**: January 2026  
+**Last Updated**: February 2026  
 **Maintainers**: ObjectStack Core Team  
 **Status**: Living Document

README.md

@@ -160,6 +160,19 @@ os doctor            # Check environment health
 | [`@example/app-host`](examples/app-host) | Server host — multi-app orchestration with plugins | 🔴 Advanced |
 | [`@example/plugin-bi`](examples/plugin-bi) | BI plugin — analytics objects and reports | 🟡 Intermediate |
 
+## 🗺️ Roadmap
+
+See **[ROADMAP.md](./ROADMAP.md)** for the next-phase optimization and improvement plan (Phases 5–11), covering:
+
+- Spec test coverage completion (100% schema coverage)
+- Runtime package hardening (resolve all TODOs)
+- Framework adapter implementations (Hono, Next.js, NestJS)
+- Deprecation cleanup & v3.0 preparation
+- Developer experience & tooling improvements
+- Performance optimization & security hardening
+
+Studio-specific roadmap: **[apps/studio/ROADMAP.md](./apps/studio/ROADMAP.md)**
+
 ## 🤝 Contributing
 
 We welcome contributions! Please read our **[Contributing Guide](./CONTRIBUTING.md)** for: