diff --git a/README.md b/README.md
index 6a215e8..5bea7e8 100644
--- a/README.md
+++ b/README.md
@@ -1,190 +1,5 @@
-
-
-
Composer Config Plugin
-
-
+# DEPRECATED
-Composer plugin for config assembling.
+**in favour of [yiisoft/composer-config-plugin]**
-[![Latest Stable Version](https://poser.pugx.org/hiqdev/composer-config-plugin/v/stable)](https://packagist.org/packages/hiqdev/composer-config-plugin)
-[![Total Downloads](https://poser.pugx.org/hiqdev/composer-config-plugin/downloads)](https://packagist.org/packages/hiqdev/composer-config-plugin)
-[![Build Status](https://img.shields.io/travis/hiqdev/composer-config-plugin.svg)](https://travis-ci.org/hiqdev/composer-config-plugin)
-[![Scrutinizer Code Coverage](https://img.shields.io/scrutinizer/coverage/g/hiqdev/composer-config-plugin.svg)](https://scrutinizer-ci.com/g/hiqdev/composer-config-plugin/)
-[![Scrutinizer Code Quality](https://img.shields.io/scrutinizer/g/hiqdev/composer-config-plugin.svg)](https://scrutinizer-ci.com/g/hiqdev/composer-config-plugin/)
-[![Dependency Status](https://www.versioneye.com/php/hiqdev:composer-config-plugin/dev-master/badge.svg)](https://www.versioneye.com/php/hiqdev:composer-config-plugin/dev-master)
-
-This [Composer] plugin provides assembling
-of configurations distributed with composer packages.
-It allows putting configuration needed to use a package right inside of
-the package thus implementing a plugin system. The package becomes a plugin
-holding both the code and its configuration.
-
-How it works?
-
-- Scans installed packages for `config-plugin` extra option in their
- `composer.json`
-- Loads `.env` files to set `$_ENV` variables
-- Requires `defines` files to set constants
-- Requires `params` files
-- Requires config files
-- Options collected during earlier steps could and should be used in later
- steps, e.g. `$_ENV` should be used for constants and parameters, which
- in turn should be used for configs
-- File processing order is crucial to achieve expected behavior: options
- in root package have priority over options from included packages. It is described
- below in **File processing order** section.
-- Collected configs are written as PHP files in
- `vendor/hiqdev/composer-config-plugin-output`
- directory along with information needed to rebuild configs on demand
-- Then assembled configs are ready to be loaded into application using `require`
-
-**Read more** about the general idea behind this plugin in [English] or
-[Russian].
-
-[composer]: https://getcomposer.org/
-[English]: https://hiqdev.com/pages/articles/app-organization
-[Russian]: https://habrahabr.ru/post/329286/
-
-## Installation
-
-```sh
-composer require "hiqdev/composer-config-plugin"
-```
-
-Out of the box this plugin supports configs in PHP and JSON formats.
-
-To enable additional formats require:
-
-- [vlucas/phpdotenv] - for `.env` files
-- [symfony/yaml] - for YAML files, `.yml` and `.yaml`
-
-[vlucas/phpdotenv]: https://github.com/vlucas/phpdotenv
-[symfony/yaml]: https://github.com/symfony/yaml
-
-## Usage
-
-List your config files in `composer.json` like the following:
-
-```json
-"extra": {
- "config-plugin-output-dir": "path/relative-to-composer-json",
- "config-plugin": {
- "params": [
- "config/params.php",
- "?config/params-local.php"
- ],
- "common": "config/common.php",
- "web": [
- "$common",
- "config/web.php"
- ],
- "other": "config/other.php"
- }
-},
-```
-
-`?` marks optional files. Absence of files not marked with it will cause exception.
-
-`$common` is inclusion - `common` config will be merged into `web`.
-
-Define your configs like the following:
-
-```php
-return [
- 'components' => [
- 'db' => [
- 'class' => \my\Db::class,
- 'name' => $params['db.name'],
- 'password' => $params['db.password'],
- ],
- ],
-];
-```
-
-To load assembled configs in your application use `require`:
-
-```php
-$config = require hiqdev\composer\config\Builder::path('web');
-```
-
-### Refreshing config
-
-Plugin uses composer `POST_AUTOLOAD_DUMP` event i.e. composer runs this plugin on `install`, `update` and `dump-autoload`
-commands. As the result configs are ready to be used right after package installation or update.
-
-When you make changes to any of configs you may want to reassemble configs manually. In order to do it run:
-
-```sh
-composer dump-autoload
-```
-
-Above can be shortened to `composer du`.
-
-If you need to force config rebuildign from your application, you can do it like the following:
-
-```php
-// Don't do it in production, assembling takes it's time
-if (ENVIRONMENT === 'dev') {
- hiqdev\composer\config\Builder::rebuild();
-}
-```
-
-### File processing order
-
-Config files are processed in proper order to achieve naturally expected
-behavior:
-
-- Options in outer packages override options from inner packages
-- Plugin respects the order your configs are listed in `composer.json` with
-- Different types of options are processed in the following order:
- - Environment variables from `dotenv`
- - Constants from `defines`
- - Parameters from `params`
- - Configs are processed last of all
-
-### Debugging
-
-There are several ways to debug config building internals.
-
-- Plugin can show detected package dependencies hierarchy by running:
-
-```sh
-composer dump-autoload --verbose
-```
-
-Above can be shortened to `composer du -v`.
-
-- You can see the list of configs and files that plugin has detected and uses
-to build configs. It is located in `vendor/hiqdev/composer-config-plugin-output/__files.php`.
-
-- You can see the assembled configs in the output directory which is
-`vendor/hiqdev/composer-config-plugin-output` by default and can be configured
-with `config-plugin-output-dir` extra option in `composer.json`.
-
-## Known issues
-
-This plugin treats configs as simple PHP arrays. No specific
-structure or semantics are expected and handled.
-It is simple and straightforward, but I'm in doubt...
-What about errors and typos?
-I think about adding config validation rules provided together with
-plugins. Will it solve all the problems?
-
-Anonymous functions must be used in multiline form only:
-
-```php
-return [
- 'works' => function () {
- return 'value';
- },
- // this will not work
- 'noway' => function () { return 'value'; },
-];
-```
-
-## License
-
-This project is released under the terms of the BSD-3-Clause [license](LICENSE).
-Read more [here](http://choosealicense.com/licenses/bsd-3-clause).
-
-Copyright © 2016-2018, HiQDev (http://hiqdev.com/)
+[yiisoft/composer-config-plugin]: https://github.com/yiisoft/composer-config-plugin